---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideHTTPRequest - Global

# GlideHTTPRequest - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 min. de leitura

A API GlideHTTPRequest fornece métodos de utilitário para executar funções comuns com solicitações HTTP do Glide.

Você pode usar esta API em scripts globais do lado do servidor. Para usar esta classe, crie uma instância de um objeto GlideHTTPRequest usando o construtor. O construtor requer um URL de endpoint como um parâmetro de entrada.

## GlideHTTPRequest -- addHeader(cadeia de caracteres nome, cadeia de caracteres valor) {#ariaid-title2}

Adiciona um cabeçalho à sua solicitação HTTP.
{#GlideHTTPRequest-addHeader__table_ib1_31z_cfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome do cabeçalho, como `Accept` ou `Content-Type`. |
| valor | Cadeia de caracteres | Valor do cabeçalho, como `application/json`. |
[Tabela 1. Parâmetros]

{#GlideHTTPRequest-addHeader__table_ib1_31z_cfb} {#GlideHTTPRequest-addHeader__table_jb1_31z_cfb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 2. Retorna]

{#GlideHTTPRequest-addHeader__table_jb1_31z_cfb}  
Este exemplo adiciona o cabeçalho de solicitação "Aceitar" e retorna o número de incidentes de uma instância da ServiceNow, analisando as respostas JSON ou XML.

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Add the Accept header to get JSON response
    request.addHeader('Accept', 'application/json');

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());
    gs.print('(JSON) Incidents returned: ' + JSON.parse(response.getBody()).result.length);

    // Replace the Accept header to get XML response
    request.addHeader('Accept', 'application/xml');

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());
    gs.print('(XML) Incidents returned: ' + gs.xmlToJSON(response.getBody()).response.result.length);

Saída

    200
    (JSON) Incidents returned: 66
    200
    (XML) Incidents returned: 66

## GlideHTTPRequest -- addParameter(cadeia de caracteres nome, cadeia de caracteres valor) {#ariaid-title3}

Adiciona um parâmetro à sua solicitação HTTP.
{#GlideHTTPRequest-addParameter__table_zk5_4dz_cfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Parâmetro a ser adicionado, como sysparm_limit. |
| valor | Cadeia de caracteres | Valor do parâmetro. |
[Tabela 3. Parâmetros]

{#GlideHTTPRequest-addParameter__table_zk5_4dz_cfb} {#GlideHTTPRequest-addParameter__entry__11}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 4. Retorna]

Este exemplo mostra como adicionar o parâmetro sysparm_limit à chamada de endpoint REST para limitar o número de respostas retornadas.

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Add the 'sysparm_limit' parameter to limit the number of records returned
    request.addParameter('sysparm_limit', 1);

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());
    gs.print('Incidents returned: ' + JSON.parse(response.getBody()).result.length);

Saída:

    200
    Incidents returned: 1

## GlideHTTPRequest -- setBasicAuth(cadeia de caracteres userName, cadeia de caracteres password) {#ariaid-title4}

Define um nome de usuário e senha para autenticação básica.
{#GlideHTTPRequest-setBasicAuth__table_xtx_5qy_cfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| userName | Cadeia de caracteres | Nome de usuário a ser usado para autenticação. |
| senha | Cadeia de caracteres | Senha do usuário a ser usada para autenticação. |
[Tabela 5. Parâmetros]

{#GlideHTTPRequest-setBasicAuth__table_xtx_5qy_cfb} {#GlideHTTPRequest-setBasicAuth__table_ytx_5qy_cfb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 6. Retorna]

{#GlideHTTPRequest-setBasicAuth__table_ytx_5qy_cfb}  
Este exemplo mostra como usar o método setBasicAuth() para definir o nome de usuário e a senha para a chamada de endpoint REST associada.

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Add the Accept header to get JSON response
    request.addHeader('Accept', 'application/json');

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());
    gs.print('(JSON) Incidents returned: ' + JSON.parse(response.getBody()).result.length);

    // Replace the Accept header to get XML response
    request.addHeader('Accept', 'application/xml');

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());
    gs.print('(XML) Incidents returned: ' + gs.xmlToJSON(response.getBody()).response.result.length);

Saída

    200
    (JSON) Incidents returned: 66
    200
    (XML) Incidents returned: 66

## GlideHTTPRequest -- setContentType(tipo de cadeia de caracteres) {#ariaid-title5}

Define o cabeçalho Content-Type da sua solicitação HTTP com o valor especificado.
{#GlideHTTPRequest-setContentType__table_lhw_vdz_cfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tipo | Cadeia de caracteres | Tipo de conteúdo a ser definido, como `application/json` ou `multipart/form-data`. Para obter informações adicionais sobre Content-Type, consulte <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Type>. |
[Tabela 7. Parâmetros]

{#GlideHTTPRequest-setContentType__table_lhw_vdz_cfb} {#GlideHTTPRequest-setContentType__table_mhw_vdz_cfb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 8. Retorna]

{#GlideHTTPRequest-setContentType__table_mhw_vdz_cfb}  
Este exemplo mostra como definir o cabeçalho de solicitação `Content-Type` para uma chamada de endpoint REST usando o método setContentType().

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Set up incident record to post

    // Set the Content-Type of the POST
    request.setContentType('application/json');

    // Execute the POST request
    var response = request.post();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());

Saída

    200

## GlideHTTPRequest - setFollowRedirect(booliano sigaRedirecionar) {#ariaid-title6}

Habilita ou desabilita a opção de redirecionamento de acompanhamento para uma chamada de endpoint REST.
Para obter informações adicionais sobre redirecionamentos HTTP, consulte <https://developer.mozilla.org/en-US/docs/Web/HTTP/Redirections>.
{#GlideHTTPRequest-setFollowRedirect__table_kzt_pwy_cfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| seguirRedirecionar | Booliano | Sinalizador que indica se o endpoint deve seguir qualquer redirecionamento de URL retornado pelo endpoint. Valores válidos: * verdadeiro: após qualquer redirecionamento retornado. * falso: ignora qualquer redirecionamento retornado. Padrão: verdadeiro |
[Tabela 9. Parâmetros]

{#GlideHTTPRequest-setFollowRedirect__table_kzt_pwy_cfb} {#GlideHTTPRequest-setFollowRedirect__table_lzt_pwy_cfb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 10. Retorna]

{#GlideHTTPRequest-setFollowRedirect__table_lzt_pwy_cfb}  
Este exemplo mostra como desativar redirecionamentos para uma chamada de endpoint usando o método setFollowRedirect().

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Add the Accept header to get JSON response
    request.addHeader('Accept', 'application/json');

    // Turn off follow redirect - default is on (true)
    request.setFollowRedirect(false);

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());

Saída

    200

## GlideHTTPRequest -- setHttpTimeout(int timeout) {#ariaid-title7}

Define o valor de tempo limite de HTTP em milissegundos.
{#GlideHTTPRequest-setHttpTimeout__table_rjp_1ly_cfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tempo limite | Inteiro | Valor de tempo limite a ser definido. Unidade: Milissegundos |
[Tabela 11. Parâmetros]

{#GlideHTTPRequest-setHttpTimeout__table_rjp_1ly_cfb} {#GlideHTTPRequest-setHttpTimeout__table_sjp_1ly_cfb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 12. Retorna]

{#GlideHTTPRequest-setHttpTimeout__table_sjp_1ly_cfb}  
Este exemplo mostra como definir o valor de tempo limite para uma chamada de endpoint usando o método setTimeout().

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Add the Accept header to get JSON response
    request.addHeader('Accept', 'application/json');

    // Set the time out value
    request.setHttpTimeOut(1000);

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());

Saída

    200

## GlideHTTPRequest -- setLogLevel(cadeia de caracteres logLevel) {#ariaid-title8}

Define o nível de log para uma solicitação HTTP.
{#GlideHTTPRequest-setLogLevel__table_ijx_myy_cfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| logLevel | Cadeia de caracteres | O nível de registro em log disponível. Nota: Por motivos de desempenho, na produção, é aconselhável deixar o registro em log da solicitação HTTP em basic. Valores válidos: * básico: cobre muitos dos atributos da transação HTTP, incluindo host, caminho, status de resposta e assim por diante. * elevado: inclui todos os basic, bem como todos os cabeçalhos de solicitação, a cadeia de caracteres de consulta e todos os cabeçalhos de resposta. * tudo: inclui todos os elevated, bem como o corpo da solicitação e o corpo da resposta. Padrão: básico |
[Tabela 13. Parâmetros]

{#GlideHTTPRequest-setLogLevel__table_ijx_myy_cfb} {#GlideHTTPRequest-setLogLevel__table_jjx_myy_cfb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 14. Retorna]

{#GlideHTTPRequest-setLogLevel__table_jjx_myy_cfb}  
Este exemplo mostra como definir o nível de log para uma chamada de endpoint usando o método setLogLevel().

    var instance = 'dev12345';
    var username = 'admin';
    var password = 'yourpassword';

    // Instantiate request with ServiceNow API incidents table endpoint
    var request = new GlideHTTPRequest('https://'+instance+'.service-now.com/api/now/table/incident');

    // Add authentication data
    request.setBasicAuth(username, password);

    // Add the Accept header to get JSON response
    request.addHeader('Accept', 'application/json');

    // Set the time out value
    request.setLogLevel(elevated);

    // Execute the GET request
    var response = request.get();

    // Print the results: status code and number of records returned
    gs.print(response.getStatusCode());

Saída

    200

## GlideHTTPRequest - setupProxy (cadeia de caracteres host, cadeia de caracteres porta) {#ariaid-title9}

Define o host e a porta do proxy para a chamada REST associada.
{#GlideHTTPRequest-setupProxy__table_aww_sry_cfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Host | Cadeia de caracteres | Host do proxy |
| porta | Cadeia de caracteres | Porta de proxy |
[Tabela 15. Parâmetros]

{#GlideHTTPRequest-setupProxy__table_aww_sry_cfb} {#GlideHTTPRequest-setupProxy__table_bww_sry_cfb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 16. Retorna]

{#GlideHTTPRequest-setupProxy__table_bww_sry_cfb}