Buscar - com escopo, global

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura

    • A API de busca fornece métodos para buscar recursos usando objetos de solicitação e resposta.

    Você pode usar a API de busca em um script em segundo plano e onde quer que possa fazer chamadas HTTP (como um endpoint REST). A API de busca permite que você faça solicitações de busca simples e mais complicadas definindo cabeçalhos, opções de corpo e assim por diante.

    Esta API faz parte de um conjunto de APIs de busca, que fornecem várias ações para buscar recursos de sites externos. A coleção completa da API de busca inclui:

    Para oferecer suporte a ações de busca, a propriedade do sistema, glide.hosts.allowlist, permite controles sobre quais hosts um método de busca pode acessar. Aplica-se a APIs HTTP como RestMessageV2 e as mencionadas acima. Para obter mais informações sobre glide.hosts.allowlist, consulte Available system properties.

    Buscar - fetch (recurso de cadeia de caracteres, opções de objeto)

    Inicia o processo de busca de um recurso da rede e retorna uma promessa que é cumprida quando a resposta está disponível.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    recurso Cadeia de caracteres ou objeto Obrigatório. O recurso a ser buscado.
    Valores aceitos:
    • Uma cadeia de caracteres ou um objeto com um stringifier, incluindo um objeto URL, que fornece o URL do recurso que você deseja buscar. O URL pode ser relativo ao URL base, que é o baseURI do documento.
    • Um objeto Buscar solicitação - Request().
    opções Objeto Opcional. Um objeto Buscar RequestInit - com escopo, global que contém configurações personalizadas a serem aplicadas à solicitação.

    Padrão: a solicitação é aprovada sem configurações de personalização.
    Tabela 2. Retornos
    Tipo Descrição
    Objeto Uma promessa que é resolvida para um objeto de resposta.
    Uma promessa fetch() só é rejeitada quando a solicitação falha, por exemplo, devido a um URL de solicitação malformado ou a um erro de rede.
    Nota:
    Uma promessa fetch() não será considerada rejeitada se o servidor responder com códigos de status HTTP que indicam erros como 404 ou 504. Nesta instância, use um manipulador "then()" para verificar as propriedades "ok" e "status Buscar resposta - com escopo, global" .
    O exemplo a seguir demonstra como formar um novo objeto Request usando Buscar solicitação - Request() e, em seguida, fetch() para recuperar seus dados. Aqui está uma explicação simples de como cada parte do código é usada:
    async function fetchIncidents() {
    const url = 'https://your-instance.service-now.com/api/now/table/incident';
    const username = 'your_username';
    const password = 'your_password';

    // Create a Request object
    const request = new Request(url, {
        method: 'GET',
        headers: {
            'Content-Type': 'application/json',
            Authorization: 'Basic ' + btoa(`${username}:${password}`)
        }
    });

    // Fetch data and use response.json() to process it
    const response = await fetch(request);
    const data = await response.json(); // Parse the response to JSON
    console.log(data.result); // Log the incidents data to system logs
}

fetchIncidents();

    Saída:

    [
    { "number": "INC0001", "short_description": "System outage" },
    { "number": "INC0002", "short_description": "Password reset request" }
]