Buscar - Escopo, Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • . Buscar A API fornece métodos para buscar recursos usando objetos de solicitação e resposta.

    Você pode usar Buscar API em um script em segundo plano e onde você pode fazer chamadas HTTP (como um endpoint REST). . Buscar A API 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 Buscar APIs, que fornecem várias ações para buscar recursos de sites externos. A coleção completa da API Fetch inclui:

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

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

    Inicia o processo de buscar 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 obtido.
    Valores aceitos:
    • Uma cadeia de caracteres ou um objeto com um stringifier, incluindo um objeto URL, que fornece a URL do recurso que você deseja buscar. O URL pode ser relativo ao URL base, que é o baseURI do documento.
    • . Buscar solicitação - request() objeto.
    opções Objeto Opcional. . Buscar SolicitInit - Escopo, Global objeto que contém configurações personalizadas a serem aplicadas à solicitação.

    Padrão: A solicitação é aprovada sem nenhuma configuração de personalização.

    Tabela 2. Retornos
    Tipo Descrição
    Objeto Uma promessa que resolve um objeto de resposta.
    . buscar() A promessa só é rejeitada quando a solicitação falha, por exemplo, devido a um URL de solicitação mal formado ou a um erro de rede.
    Nota:
    . buscar() A promessa 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 then() manipulador para verificar o ok e o status Buscar resposta - Escopo, Global propriedades.
    O exemplo a seguir demonstra como formar um novo objeto de solicitação usando Buscar solicitação - request() e então buscar() 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" }
    ]