API da tabela
. Tabela A API fornece endpoints que permitem executar operações de criação, leitura, atualização e exclusão (CRUD) em tabelas existentes.
O usuário solicitante deve ter funções suficientes para acessar os dados na tabela especificada na solicitação.
Tabela - EXCLUA /now/table/tablename//sys_id
Exclui o registro especificado da tabela especificada.
Formato de URL
URL com controle de versão: /api/now/api/table/tablename/sys_id
URL padrão: /api/now/table/
Nota:
As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no Serviço REST com script .
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint para acessar. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| sys_id | Sys_id do registro a ser excluído. Tipo de dados: Cadeia de caracteres |
| tableName | Nome da tabela da qual excluir o registro especificado, como "incidente" ou "ativo". Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| sysparm_query_no_domain | Sinalizador que indica se a pesquisa de registro deve ser restrita somente aos domínios para os quais o usuário conectado está configurado. Valores válidos:
Tipo de dados: Booliano Padrão: falso Nota: . sysparm_query_no_domaino parâmetro está disponível somente para administradores do sistema ou usuários que tenham a função query_no_domain_table_api. |
| Nome | Descrição |
|---|---|
| Nenhum(a) |
Cabeçalhos
Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos da REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Aceitar | Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json |
| Cabeçalho | Descrição |
|---|---|
| Nenhum(a) |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte REST API códigos de resposta HTTP .
| Código de status | Descrição |
|---|---|
| 204 | Indica que a solicitação foi concluída com sucesso. |
Parâmetros do corpo da resposta (JSON ou XML)
| Nome | Descrição |
|---|---|
| Nenhum(a) |
Solicitação de curl
Exclua um registro da tabela Incidente.
curl "https://instance.servicenow.com/api/now/table/incident/d977b66a4f411200adf9f8e18110c7b2" \
--request DELETE \
--header "Accept:application/json" \
--user 'username':'password'Não há corpo de resposta.
NoneTabela - OBTER /now/table/
Recupera vários registros da tabela especificada.
Para obter instruções básicas, consulte Recupere incidentes existentes .
Formato de URL
URL com controle de versão: /api/now/
URL padrão: /api/now/table/
Nota:
As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no Serviço REST com script .
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint para acessar. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Dependendo da versão, este endpoint retorna resultados diferentes em uma consulta válida.
Tipo de dados: Cadeia de caracteres |
| tableName | Nome da tabela da qual recuperar os registros. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| pares nome-valor | Pares nome-valor a serem usados para filtrar o conjunto de resultados. Este parâmetro é mutuamente exclusivo com sysparm_query. Por exemplo, em vez de usar &sysparm_query , você pode simplificar a instrução de chamada usando verdadeiro . Você também pode usar o valor de exibição quando o campo for um campo do tipo de escolha ou referência, como &estado: encerrado em vez de &estado: 7 . Para especificar vários pares chave-valor, separe cada um com um e comercial, como "true&assigned_to: john.smith" .Tipo de dados: Cadeia de caracteres |
| sysparm_display_value | Determina o tipo de dados retornados, os valores reais do banco de dados ou os valores de exibição dos campos. Os valores de exibição são manipulados com base no valor real no banco de dados e nas configurações e preferências do usuário ou do sistema. Se retornar valores de exibição, o valor retornado dependerá do tipo de campo.
Tipo de dados: Cadeia de caracteres Valores válidos:
Padrão: falso Nota: Não há método preferencial para definir este parâmetro. No entanto, especificar o valor de exibição pode causar problemas de desempenho, pois ele não está lendo diretamente do banco de dados e pode incluir a referência a outros campos e registros. Para obter mais informações sobre valores de exibição e valores reais, consulte Tabela de perguntas frequentes da API (KB0534905). |
| sysparm_exclude_reference_link | Sinalizador que indica se os links da API de tabela devem ser excluídos para campos de referência. Valores válidos:
Tipo de dados: Booliano Padrão: falso |
| sysparm_fields | Lista separada por vírgulas de campos a serem retornados na resposta. Campos inválidos são ignorados. Tipo de dados: Cadeia de caracteres Padrão: Retornar todos os campos. |
| sysparm_limit | Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro. Este limite é aplicado antes da avaliação da ACL. Se nenhum registro retornar, incluindo registros aos quais você tem acesso, reorganize a ordem de registro para que os registros que você tenha acesso para retornar primeiro. Nota:
Excepcionalmente grande sysparm_limitos valores podem afetar o desempenho do sistema. Tipo de dados: Número Padrão: 20 Máximo: 100 |
| sysparm_no_count | Sinalizador que indica se um deve ser executado contagem de seleção(*) consulte a tabela para retornar o número de linhas na tabela associada.Valores válidos:
Tipo de dados: Booliano Padrão: falso |
| sysparm_offset | Índice de registro inicial para o qual iniciar a recuperação de registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis. Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetestá definido como "0". Para simplesmente percorrer todos os registros disponíveis, use Tipo de dados: Número Padrão: 0 |
| sysparm_query | Consulta codificada usado para filtrar o conjunto de resultados. Você pode usar um filtro de IU para obter uma consulta codificada corretamente. Sintaxe: <col_name> <operator> <value> .
Todos os parâmetros diferenciam maiúsculas de minúsculas. As consultas podem conter mais de uma entrada, como <col_name> <operator> <value>[<operator> <col_name> <operator> <value>] . Por exemplo:
As consultas codificadas também são compatíveis com a funcionalidade ordenar por. Para classificar respostas com base em determinados campos, use Sintaxe:
Por exemplo: Esta consulta filtra todos os registros ativos e ordena os resultados em ordem crescente por número e, em seguida, em ordem decrescente por categoria. Se parte da consulta for inválida, por exemplo, especificando um nome de campo inválido, a instância ignorará a parte inválida. Em seguida, retorna linhas usando apenas a parte válida da consulta. Você pode controlar esse comportamento usando a propriedade glide.invalid_query.returns_no_rows. Defina esta propriedade como verdadeira para não retornar linhas em uma consulta inválida. Nota: . glide.invalid_query.returns_no_rowsa propriedade controla o comportamento de todas as consultas na instância, como em listas, scripts ( GlideRecord.query() E APIs de serviço web. Tipo de dados: Cadeia de caracteres |
| sysparm_query_category | Nome da categoria a ser usada para consultas. Tipo de dados: Cadeia de caracteres |
| sysparm_query_no_domain | Sinalizador que indica se a pesquisa de registro deve ser restrita somente aos domínios para os quais o usuário conectado está configurado. Valores válidos:
Tipo de dados: Booliano Padrão: falso Nota: . sysparm_query_no_domaino parâmetro está disponível somente para administradores do sistema ou usuários que tenham a função query_no_domain_table_api. |
| sysparm_suppress_pagination_header | Sinalizador que indica se o cabeçalho do link deve ser removido da resposta. O cabeçalho do Link fornece vários URLs para páginas relativas no conjunto de registros que você pode usar para paginar o conjunto de registros retornado. Valores válidos:
Tipo de dados: Booliano Padrão: falso |
| sysparm_view | Exibição de IU para a qual os dados serão renderizados. Determina os campos retornados na resposta. Valores válidos:
Se você também especificar o. sysparm_fieldsparâmetro, ele tem precedente. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| Nenhum(a) |
Cabeçalhos
Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos da REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Aceitar | Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json |
| Cabeçalho | Descrição |
|---|---|
| Link | URLs relativos, com base na solicitação anterior, que você pode usar para percorrer o conjunto de registros disponível. Por exemplo:
|
| X-Total-Count | Contagem total de registros retornados pela consulta. |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte REST API códigos de resposta HTTP .
| Código de status | Descrição |
|---|---|
| 200 | Solicitação concluída com sucesso. Se uma consulta válida não retornou resultados, o corpo da resposta conterá apenas uma matriz de resultados vazia. |
Parâmetros do corpo da resposta (JSON ou XML)
| Parâmetro | Descrição |
|---|---|
| pares nome-valor | Nomes de campo e valores de todos os parâmetros no registro especificado ou aqueles especificados nos parâmetros de consulta. |
Solicitação de curl
Recupere o primeiro registro da tabela de problemas.
curl "https://instance.servicenow.com/api/now/table/problem?sysparm_limit=1" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'A resposta contém os pares nome-valor para o registro solicitado.
{
"result": [
{
"parent": "",
"made_sla": "true",
"watch_list": "",
"upon_reject": "cancel",
"sys_updated_on": "2016-01-19 04:52:04",
"approval_history": "",
"number": "PRB0000050",
"sys_updated_by": "glide.maint",
"opened_by": {
"link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint",
"value": "glide.maint"
},
"user_input": "",
"sys_created_on": "2016-01-19 04:51:19",
"sys_domain": {
"link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
"value": "global"
},
"state": "4",
"sys_created_by": "glide.maint",
"knowledge": "false",
"order": "",
"closed_at": "2016-01-19 04:52:04",
"cmdb_ci": {
"link": "https://instance.servicenow.com/api/now/table/cmdb_ci/55b35562c0a8010e01cff22378e0aea9",
"value": "55b35562c0a8010e01cff22378e0aea9"
},
"delivery_plan": "",
"impact": "3",
"active": "false",
"work_notes_list": "",
"business_service": "",
"priority": "4",
"sys_domain_path": "/",
"time_worked": "",
"expected_start": "",
"rejection_goto": "",
"opened_at": "2016-01-19 04:49:47",
"business_duration": "1970-01-01 00:00:00",
"group_list": "",
"work_end": "",
"approval_set": "",
"wf_activity": "",
"work_notes": "",
"short_description": "Switch occasionally drops connections",
"correlation_display": "",
"delivery_task": "",
"work_start": "",
"assignment_group": "",
"additional_assignee_list": "",
"description": "Switch occasionally drops connections",
"calendar_duration": "1970-01-01 00:02:17",
"close_notes": "updated firmware",
"sys_class_name": "problem",
"closed_by": "",
"follow_up": "",
"sys_id": "04ce72c9c0a8016600b5b7f75ac67b5b",
"contact_type": "phone",
"urgency": "3",
"company": "",
"reassignment_count": "",
"activity_due": "",
"assigned_to": "",
"comments": "",
"approval": "not requested",
"sla_due": "",
"comments_and_work_notes": "",
"due_date": "",
"sys_mod_count": "1",
"sys_tags": "",
"escalation": "0",
"upon_approval": "proceed",
"correlation_id": "",
"location": ""
}
]
}Tabela - OBTER /now/table/tablename//sys_id
Recupera o registro identificado pelo sys_id especificado da tabela especificada.
Formato de URL
URL com controle de versão: /api/now/api/table/tablename/sys_id
URL padrão: /api/now/table/
Nota:
As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no Serviço REST com script .
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint para acessar. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| sys_id | Sys_id do registro a ser recuperado. Tipo de dados: Cadeia de caracteres |
| tableName | Nome da tabela da qual recuperar o registro. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| sysparm_display_value | Determina o tipo de dados retornados, os valores reais do banco de dados ou os valores de exibição dos campos. Os valores de exibição são manipulados com base no valor real no banco de dados e nas configurações e preferências do usuário ou do sistema. Se retornar valores de exibição, o valor retornado dependerá do tipo de campo.
Tipo de dados: Cadeia de caracteres Valores válidos:
Padrão: falso Nota: Não há método preferencial para definir este parâmetro. No entanto, especificar o valor de exibição pode causar problemas de desempenho, pois ele não está lendo diretamente do banco de dados e pode incluir a referência a outros campos e registros. Para obter mais informações sobre valores de exibição e valores reais, consulte Tabela de perguntas frequentes da API (KB0534905). |
| sysparm_exclude_reference_link | Sinalizador que indica se os links da API de tabela devem ser excluídos para campos de referência. Valores válidos:
Tipo de dados: Booliano Padrão: falso |
| sysparm_fields | Lista separada por vírgulas de campos a serem retornados na resposta. Campos inválidos são ignorados. Tipo de dados: Cadeia de caracteres Padrão: Retornar todos os campos. |
| sysparm_query_no_domain | Sinalizador que indica se a pesquisa de registro deve ser restrita somente aos domínios para os quais o usuário conectado está configurado. Valores válidos:
Tipo de dados: Booliano Padrão: falso Nota: . sysparm_query_no_domaino parâmetro está disponível somente para administradores do sistema ou usuários que tenham a função query_no_domain_table_api. |
| sysparm_view | Exibição de IU para a qual os dados serão renderizados. Determina os campos retornados na resposta. Valores válidos:
Se você também especificar o. sysparm_fieldsparâmetro, ele tem precedente. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| Nenhum(a) |
Cabeçalhos
Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos da REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Aceitar | Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json |
| Cabeçalho | Descrição |
|---|---|
| Nenhum(a) |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte REST API códigos de resposta HTTP .
| Código de status | Descrição |
|---|---|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 404 | Não encontrado. O item solicitado não foi encontrado. |
Parâmetros do corpo da resposta (JSON ou XML)
| Parâmetro | Descrição |
|---|---|
| pares nome-valor | Nomes de campo e valores de todos os parâmetros no registro especificado ou aqueles especificados nos parâmetros de consulta. |
Solicitação de curl
Recupere um registro da tabela Incidente.
curl "https://instance.servicenow.com/api/now/table/incident/a9e30c7dc61122760116894de7bcc7bd" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'A resposta contém os pares nome-valor para o registro solicitado.
{
"result": {
"upon_approval": "",
"location": {
"link": "https://instance.servicenow.com/api/now/table/cmn_location/105cf7f3c611227501e75e08b14a38ba",
"value": "105cf7f3c611227501e75e08b14a38ba"
},
"expected_start": "",
"reopen_count": "",
"close_notes": "",
"additional_assignee_list": "",
"impact": "1",
"urgency": "3",
"correlation_id": "",
"sys_tags": "",
"sys_domain": {
"link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
"value": "global"
},
"description": "",
"group_list": "",
"priority": "3",
"delivery_plan": "",
"sys_mod_count": "4",
"work_notes_list": "",
"business_service": "",
"follow_up": "",
"closed_at": "",
"sla_due": "2015-11-11 22:04:15",
"delivery_task": "",
"sys_updated_on": "2015-11-01 22:37:27",
"parent": "",
"work_end": "",
"number": "INC0000046",
"closed_by": "",
"work_start": "",
"calendar_stc": "",
"category": "software",
"business_duration": "",
"incident_state": "1",
"activity_due": "",
"correlation_display": "",
"company": "",
"active": "true",
"due_date": "",
"assignment_group": {
"link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a4dde73c6112278017a6a4baf547aa7",
"value": "8a4dde73c6112278017a6a4baf547aa7"
},
"caller_id": {
"link": "https://instance.servicenow.com/api/now/table/sys_user/46c6f9efa9fe198101ddf5eed9adf6e7",
"value": "46c6f9efa9fe198101ddf5eed9adf6e7"
},
"knowledge": "false",
"made_sla": "false",
"comments_and_work_notes": "",
"parent_incident": "",
"state": "1",
"user_input": "",
"sys_created_on": "2015-11-01 22:05:30",
"approval_set": "",
"reassignment_count": "1",
"rfc": "",
"child_incidents": "",
"opened_at": "2015-11-02 22:04:15",
"short_description": "Can't access SFA software",
"order": "",
"sys_updated_by": "glide.maint",
"resolved_by": "",
"notify": "1",
"upon_reject": "",
"approval_history": "",
"problem_id": {
"link": "https://instance.servicenow.com/api/now/table/problem/a9e4890bc6112276003d7a5a5c774a74",
"value": "a9e4890bc6112276003d7a5a5c774a74"
},
"work_notes": "",
"calendar_duration": "",
"close_code": "",
"sys_id": "a9e30c7dc61122760116894de7bcc7bd",
"approval": "not requested",
"caused_by": "",
"severity": "3",
"sys_created_by": "admin",
"resolved_at": "",
"assigned_to": "",
"business_stc": "",
"wf_activity": "",
"sys_domain_path": "/",
"cmdb_ci": {
"link": "https://instance.servicenow.com/api/now/table/cmdb_ci/a9c0c8d2c6112276018f7705562f9cb0",
"value": "a9c0c8d2c6112276018f7705562f9cb0"
},
"opened_by": {
"link": "https://instance.servicenow.com/api/now/table/sys_user/46c6f9efa9fe198101ddf5eed9adf6e7",
"value": "46c6f9efa9fe198101ddf5eed9adf6e7"
},
"subcategory": "",
"rejection_goto": "",
"sys_class_name": "incident",
"watch_list": "",
"time_worked": "",
"contact_type": "phone",
"escalation": "0",
"comments": ""
}
}Tabela - PATCH /now/table/tablename//sys_id
Atualiza o registro especificado com os pares nome-valor incluídos no corpo da solicitação.
Formato de URL
URL com controle de versão: /api/now/api/table/tablename/sys_id
URL padrão: /api/now/table/
Nota:
As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no Serviço REST com script .
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint para acessar. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| sys_id | Sys_id do registro a ser atualizado. Tipo de dados: Cadeia de caracteres |
| tableName | Nome da tabela na qual o registro especificado está localizado. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| sysparm_display_value | Determina o tipo de dados retornados, os valores reais do banco de dados ou os valores de exibição dos campos. Os valores de exibição são manipulados com base no valor real no banco de dados e nas configurações e preferências do usuário ou do sistema. Se retornar valores de exibição, o valor retornado dependerá do tipo de campo.
Tipo de dados: Cadeia de caracteres Valores válidos:
Padrão: falso Nota: Não há método preferencial para definir este parâmetro. No entanto, especificar o valor de exibição pode causar problemas de desempenho, pois ele não está lendo diretamente do banco de dados e pode incluir a referência a outros campos e registros. Para obter mais informações sobre valores de exibição e valores reais, consulte Tabela de perguntas frequentes da API (KB0534905). |
| sysparm_fields | Lista separada por vírgulas de campos a serem retornados na resposta. Campos inválidos são ignorados. Tipo de dados: Cadeia de caracteres Padrão: Retornar todos os campos. |
| sysparm_input_display_value | Sinalizador que indica se valores de campo devem ser definidos usando o valor de exibição ou o valor real. Dependendo dos diferentes tipos de campos, o endpoint pode manipular os valores de exibição passados para armazenar os valores apropriados no banco de dados. Por exemplo, se você enviar o nome de exibição de um campo de referência, o endpoint armazenará o sys_id desse valor no banco de dados. Para campos de data e hora, quando este parâmetro for verdadeiro, o valor de data e hora será ajustado para o fuso horário do usuário atual. Quando falso, o valor de data e hora é inserido usando o fuso horário GMT. Valores válidos:
Tipo de dados: Booliano Padrão: Falso - corresponde ao tipo de dados retornado durante a recuperação de dados (métodos DE OBTENÇÃO), que são os valores reais. Nota: Para definir o valor de um campo criptografado, defina este parâmetro como verdadeiro . Se este parâmetro não estiver definido como verdadeiro, os valores enviados para campos criptografados não serão salvos. Além disso, o usuário solicitante deve ter o contexto de criptografia apropriado antes de enviar a solicitação. Os campos criptografados estão ocultos para usuários sem o contexto de criptografia apropriado. Para obter mais informações sobre criptografia de campo, consulte Encryption. |
| sysparm_query_no_domain | Sinalizador que indica se a pesquisa de registro deve ser restrita somente aos domínios para os quais o usuário conectado está configurado. Valores válidos:
Tipo de dados: Booliano Padrão: falso Nota: . sysparm_query_no_domaino parâmetro está disponível somente para administradores do sistema ou usuários que tenham a função query_no_domain_table_api. |
| sysparm_view | Exibição de IU para a qual os dados serão renderizados. Determina os campos retornados na resposta. Valores válidos:
Se você também especificar o. sysparm_fieldsparâmetro, ele tem precedente. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| pares nome-valor | Nome do campo e o novo valor de cada parâmetro a ser atualizado no registro especificado. Nota: Todos os campos em um registro podem não estar disponíveis para atualização. Por exemplo, os campos que têm o prefixo "sys_" são normalmente parâmetros do sistema gerados automaticamente e não podem ser atualizados. |
Cabeçalhos
Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos da REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Aceitar | Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json |
| Tipo de conteúdo | Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json |
| Corpo-sem-resposta-X | Por padrão, as respostas incluem o conteúdo do corpo detalhando o registro modificado. Defina este cabeçalho de solicitação como verdadeiro para suprimir o corpo da resposta. |
| Cabeçalho | Descrição |
|---|---|
| Nenhum(a) |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte REST API códigos de resposta HTTP .
| Código de status | Descrição |
|---|---|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada. |
| 404 | Não encontrado. O item solicitado não foi encontrado. |
Parâmetros do corpo da resposta (JSON ou XML)
| Nome | Descrição |
|---|---|
| pares nome-valor | Nomes de campo e valores de todos os parâmetros no registro especificado ou aqueles especificados nos parâmetros de consulta. |
Solicitação de curl
Atualize um registro na tabela Incidente.
curl "https://instance.servicenow.com/api/now/table/incident/ef43c6d40a0a0b5700c77f9bf387afe3" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{'assigned_to':'681b365ec0a80164000fb0b05854a0cd','urgency':'1','comments':'Elevating urgency, this is a blocking issue'}" \
--user 'username':'password'A resposta contém os pares nome-valor para o registro atualizado.
{
"result": {
"upon_approval": "proceed",
"location": {
"link": "https://instance.servicenow.com/api/now/table/cmn_location/108752c8c611227501d4ab0e392ba97f",
"value": "108752c8c611227501d4ab0e392ba97f"
},
"expected_start": "",
"reopen_count": "",
"close_notes": "",
"additional_assignee_list": "",
"impact": "1",
"urgency": "1",
"correlation_id": "",
"sys_tags": "",
"sys_domain": {
"link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
"value": "global"
},
"description": "",
"group_list": "",
"priority": "1",
"delivery_plan": "",
"sys_mod_count": "7",
"work_notes_list": "",
"business_service": "",
"follow_up": "",
"closed_at": "",
"sla_due": "2017-07-05 05:58:24",
"delivery_task": "",
"sys_updated_on": "2016-01-22 14:12:37",
"parent": "",
"work_end": "",
"number": "INC0000050",
"closed_by": "",
"work_start": "",
"calendar_stc": "",
"category": "hardware",
"business_duration": "",
"incident_state": "2",
"activity_due": "2016-01-22 16:12:37",
"correlation_display": "",
"company": {
"link": "https://instance.servicenow.com/api/now/table/core_company/31bea3d53790200044e0bfc8bcbe5dec",
"value": "31bea3d53790200044e0bfc8bcbe5dec"
},
"active": "true",
"due_date": "",
"assignment_group": {
"link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a5055c9c61122780043563ef53438e3",
"value": "8a5055c9c61122780043563ef53438e3"
},
"caller_id": {
"link": "https://instance.servicenow.com/api/now/table/sys_user/5b7c200d0a640069006b3845b5d0fa7c",
"value": "5b7c200d0a640069006b3845b5d0fa7c"
},
"knowledge": "false",
"made_sla": "true",
"comments_and_work_notes": "",
"parent_incident": "",
"state": "2",
"user_input": "",
"sys_created_on": "2015-11-02 18:05:40",
"approval_set": "",
"reassignment_count": "0",
"rfc": "",
"child_incidents": "",
"opened_at": "2015-11-02 21:58:24",
"short_description": "Can't access Exchange server - is it down?",
"order": "",
"sys_updated_by": "admin",
"resolved_by": "",
"notify": "1",
"upon_reject": "cancel",
"approval_history": "",
"problem_id": "",
"work_notes": "",
"calendar_duration": "",
"close_code": "",
"sys_id": "ef43c6d40a0a0b5700c77f9bf387afe3",
"approval": "not requested",
"caused_by": "",
"severity": "3",
"sys_created_by": "glide.maint",
"resolved_at": "",
"assigned_to": {
"link": "https://instance.servicenow.com/api/now/table/sys_user/681b365ec0a80164000fb0b05854a0cd",
"value": "681b365ec0a80164000fb0b05854a0cd"
},
"business_stc": "",
"wf_activity": "",
"sys_domain_path": "/",
"cmdb_ci": {
"link": "https://instance.servicenow.com/api/now/table/cmdb_ci/281190e3c0a8000b003f593aa3f20ca6",
"value": "281190e3c0a8000b003f593aa3f20ca6"
},
"opened_by": {
"link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint",
"value": "glide.maint"
},
"subcategory": "",
"rejection_goto": "",
"sys_class_name": "incident",
"watch_list": "",
"time_worked": "",
"contact_type": "phone",
"escalation": "3",
"comments": ""
}
}Tabela - PUBLICAR /now/table/
Insere um registro na tabela especificada. A inserção de vários registros não é compatível com este método.
Formato de URL
URL com controle de versão: /api/now/
URL padrão: /api/now/table/
Nota:
As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no Serviço REST com script .
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint para acessar. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| tableName | Nome da tabela na qual o registro será salvo. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| sysparm_display_value | Determina o tipo de dados retornados, os valores reais do banco de dados ou os valores de exibição dos campos. Os valores de exibição são manipulados com base no valor real no banco de dados e nas configurações e preferências do usuário ou do sistema. Se retornar valores de exibição, o valor retornado dependerá do tipo de campo.
Tipo de dados: Cadeia de caracteres Valores válidos:
Padrão: falso Nota: Não há método preferencial para definir este parâmetro. No entanto, especificar o valor de exibição pode causar problemas de desempenho, pois ele não está lendo diretamente do banco de dados e pode incluir a referência a outros campos e registros. Para obter mais informações sobre valores de exibição e valores reais, consulte Tabela de perguntas frequentes da API (KB0534905). |
| sysparm_exclude_reference_link | Sinalizador que indica se os links da API de tabela devem ser excluídos para campos de referência. Valores válidos:
Tipo de dados: Booliano Padrão: falso |
| sysparm_fields | Lista separada por vírgulas de campos a serem retornados na resposta. Campos inválidos são ignorados. Tipo de dados: Cadeia de caracteres Padrão: Retornar todos os campos. |
| sysparm_input_display_value | Sinalizador que indica se valores de campo devem ser definidos usando o valor de exibição ou o valor real. Dependendo dos diferentes tipos de campos, o endpoint pode manipular os valores de exibição passados para armazenar os valores apropriados no banco de dados. Por exemplo, se você enviar o nome de exibição de um campo de referência, o endpoint armazenará o sys_id desse valor no banco de dados. Para campos de data e hora, quando este parâmetro for verdadeiro, o valor de data e hora será ajustado para o fuso horário do usuário atual. Quando falso, o valor de data e hora é inserido usando o fuso horário GMT. Valores válidos:
Tipo de dados: Booliano Padrão: Falso - corresponde ao tipo de dados retornado durante a recuperação de dados (métodos DE OBTENÇÃO), que são os valores reais. Nota: Para definir o valor de um campo criptografado, defina este parâmetro como verdadeiro . Se este parâmetro não estiver definido como verdadeiro, os valores enviados para campos criptografados não serão salvos. Além disso, o usuário solicitante deve ter o contexto de criptografia apropriado antes de enviar a solicitação. Os campos criptografados estão ocultos para usuários sem o contexto de criptografia apropriado. Para obter mais informações sobre criptografia de campo, consulte Encryption. |
| sysparm_view | Exibição de IU para a qual os dados serão renderizados. Determina os campos retornados na resposta. Valores válidos:
Se você também especificar o. sysparm_fieldsparâmetro, ele tem precedente. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| pares nome-valor | O nome do campo e o valor associado de cada parâmetro a ser definido no registro especificado. Nota: Os campos não especificados e não gerados automaticamente pelo sistema são definidos com o valor nulo do tipo de dados associado.Todos os campos em um registro podem não estar disponíveis para atualização. Por exemplo, os campos que têm o prefixo "sys_" são normalmente parâmetros do sistema gerados automaticamente e não podem ser atualizados. |
Cabeçalhos
Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos da REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Aceitar | Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json |
| Tipo de conteúdo | Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json |
| Corpo-sem-resposta-X | Por padrão, as respostas incluem o conteúdo do corpo detalhando o novo registro. Defina este cabeçalho como verdadeiro na solicitação para suprimir o corpo da resposta. |
| Cabeçalho | Descrição |
|---|---|
| Local | Local do recurso criado. |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte REST API códigos de resposta HTTP .
| Código de status | Descrição |
|---|---|
| 201 | Indica que a solicitação foi concluída com sucesso. |
| 400 | Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada. |
| 404 | Não encontrado. O item solicitado não foi encontrado. |
Parâmetros do corpo da resposta (JSON ou XML)
| Nome | Descrição |
|---|---|
| pares nome-valor | Nomes de campo e valores de todos os parâmetros no registro recém-criado ou aqueles especificados nos parâmetros de consulta. |
Solicitação de curl
Insira um novo registro na tabela Incidente.
curl "https://instance.servicenow.com/api/now/table/incident" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{'short_description':'Unable to connect to office wifi','assignment_group':'287ebd7da9fe198100f92cc8d1d2154e','urgency':'2','impact':'2'}" \
--user 'username':'password'A resposta contém os pares nome-valor para o novo registro.
{
"result": {
"upon_approval": "proceed",
"location": "",
"expected_start": "",
"reopen_count": "0",
"close_notes": "",
"additional_assignee_list": "",
"impact": "2",
"urgency": "2",
"correlation_id": "",
"sys_tags": "",
"sys_domain": {
"link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
"value": "global"
},
"description": "",
"group_list": "",
"priority": "3",
"delivery_plan": "",
"sys_mod_count": "0",
"work_notes_list": "",
"business_service": "",
"follow_up": "",
"closed_at": "",
"sla_due": "",
"delivery_task": "",
"sys_updated_on": "2016-01-22 14:28:24",
"parent": "",
"work_end": "",
"number": "INC0010002",
"closed_by": "",
"work_start": "",
"calendar_stc": "",
"category": "inquiry",
"business_duration": "",
"incident_state": "1",
"activity_due": "",
"correlation_display": "",
"company": "",
"active": "true",
"due_date": "",
"assignment_group": {
"link": "https://instance.servicenow.com/api/now/table/sys_user_group/287ebd7da9fe198100f92cc8d1d2154e",
"value": "287ebd7da9fe198100f92cc8d1d2154e"
},
"caller_id": "",
"knowledge": "false",
"made_sla": "true",
"comments_and_work_notes": "",
"parent_incident": "",
"state": "1",
"user_input": "",
"sys_created_on": "2016-01-22 14:28:24",
"approval_set": "",
"reassignment_count": "0",
"rfc": "",
"child_incidents": "0",
"opened_at": "2016-01-22 14:28:24",
"short_description": "Unable to connect to office wifi",
"order": "",
"sys_updated_by": "admin",
"resolved_by": "",
"notify": "1",
"upon_reject": "cancel",
"approval_history": "",
"problem_id": "",
"work_notes": "",
"calendar_duration": "",
"close_code": "",
"sys_id": "c537bae64f411200adf9f8e18110c76e",
"approval": "not requested",
"caused_by": "",
"severity": "3",
"sys_created_by": "admin",
"resolved_at": "",
"assigned_to": "",
"business_stc": "",
"wf_activity": "",
"sys_domain_path": "/",
"cmdb_ci": "",
"opened_by": {
"link": "https://instance.servicenow.com/api/now/table/sys_user/6816f79cc0a8016401c5a33be04be441",
"value": "6816f79cc0a8016401c5a33be04be441"
},
"subcategory": "",
"rejection_goto": "",
"sys_class_name": "incident",
"watch_list": "",
"time_worked": "",
"contact_type": "phone",
"escalation": "0",
"comments": ""
}
}Tabela - COLOQUE /now/table/
Atualiza o registro especificado com o corpo da solicitação.
Formato de URL
URL com controle de versão: /api/now/api/table/tablename/sys_id
URL padrão: /api/now/table/
Nota:
As versões disponíveis são especificadas em REST API Explorer . Para APIs REST com script, há informações adicionais de versão no Serviço REST com script .
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint para acessar. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| sys_id | Identificador exclusivo do registro a ser atualizado. Tipo de dados: Cadeia de caracteres |
| tableName | Nome da tabela na qual o registro está localizado. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| sysparm_display_value | Determina o tipo de dados retornados, os valores reais do banco de dados ou os valores de exibição dos campos. Os valores de exibição são manipulados com base no valor real no banco de dados e nas configurações e preferências do usuário ou do sistema. Se retornar valores de exibição, o valor retornado dependerá do tipo de campo.
Tipo de dados: Cadeia de caracteres Valores válidos:
Padrão: falso Nota: Não há método preferencial para definir este parâmetro. No entanto, especificar o valor de exibição pode causar problemas de desempenho, pois ele não está lendo diretamente do banco de dados e pode incluir a referência a outros campos e registros. Para obter mais informações sobre valores de exibição e valores reais, consulte Tabela de perguntas frequentes da API (KB0534905). |
| sysparm_exclude_reference_link | Sinalizador que indica se os links da API de tabela devem ser excluídos para campos de referência. Valores válidos:
Tipo de dados: Booliano Padrão: falso |
| sysparm_fields | Lista separada por vírgulas de campos a serem retornados na resposta. Campos inválidos são ignorados. Tipo de dados: Cadeia de caracteres Padrão: Retornar todos os campos. |
| sysparm_input_display_value | Sinalizador que indica se valores de campo devem ser definidos usando o valor de exibição ou o valor real. Valores válidos:
Tipo de dados: Booliano Padrão: falso Nota:
|
| sysparm_query_no_domain | Sinalizador que indica se a pesquisa de registro deve ser restrita somente aos domínios para os quais o usuário conectado está configurado. Valores válidos:
Tipo de dados: Booliano Padrão: falso Nota: . sysparm_query_no_domaino parâmetro está disponível somente para administradores do sistema ou usuários que tenham a função query_no_domain_table_api. |
| sysparm_view | Exibição de IU para a qual os dados serão renderizados. Determina os campos retornados na resposta. Valores válidos:
Se você também especificar o. sysparm_fieldsparâmetro, ele tem precedente. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| pares nome-valor | Pares nome-valor para os campos a serem atualizados na tabela associada. Por exemplo, para atualizar o arquivo de descrição resumida, insira um par nome-valor semelhante ao seguinte: --data ""short_description": "minha descrição curta""" . |
Cabeçalhos
Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos da REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Aceitar | Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json |
| Tipo de conteúdo | Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. |
| Corpo-sem-resposta-X | Por padrão, as respostas incluem o conteúdo do corpo detalhando o registro modificado. Defina este cabeçalho como verdadeiro na solicitação para suprimir o corpo da resposta. |
| Cabeçalho | Descrição |
|---|---|
| Nenhum(a) |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte REST API códigos de resposta HTTP .
| Código de status | Descrição |
|---|---|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada. |
| 404 | Não encontrado. O item solicitado não foi encontrado. |
Parâmetros do corpo da resposta (JSON ou XML)
| Nome | Descrição |
|---|---|
| pares nome-valor | Todos os campos (não apenas modificados) com seus valores associados à solicitação de mudança. |
Solicitação de curl
Atualize um registro na tabela Incidente.
curl "https://instance.servicenow.com/api/now/table/incident/ef43c6d40a0a0b5700c77f9bf387afe3" \
--request PUT \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{'assigned_to':'681b365ec0a80164000fb0b05854a0cd','urgency':'1','comments':'Elevating urgency, this is a blocking issue'}" \
--user 'username':'password'A resposta contém os pares nome-valor para o registro atualizado.
{
"result": {
"upon_approval": "proceed",
"location": {
"link": "https://instance.servicenow.com/api/now/table/cmn_location/108752c8c611227501d4ab0e392ba97f",
"value": "108752c8c611227501d4ab0e392ba97f"
},
"expected_start": "",
"reopen_count": "",
"close_notes": "",
"additional_assignee_list": "",
"impact": "1",
"urgency": "1",
"correlation_id": "",
"sys_tags": "",
"sys_domain": {
"link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
"value": "global"
},
"description": "",
"group_list": "",
"priority": "1",
"delivery_plan": "",
"sys_mod_count": "7",
"work_notes_list": "",
"business_service": "",
"follow_up": "",
"closed_at": "",
"sla_due": "2017-07-05 05:58:24",
"delivery_task": "",
"sys_updated_on": "2016-01-22 14:12:37",
"parent": "",
"work_end": "",
"number": "INC0000050",
"closed_by": "",
"work_start": "",
"calendar_stc": "",
"category": "hardware",
"business_duration": "",
"incident_state": "2",
"activity_due": "2016-01-22 16:12:37",
"correlation_display": "",
"company": {
"link": "https://instance.servicenow.com/api/now/table/core_company/31bea3d53790200044e0bfc8bcbe5dec",
"value": "31bea3d53790200044e0bfc8bcbe5dec"
},
"active": "true",
"due_date": "",
"assignment_group": {
"link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a5055c9c61122780043563ef53438e3",
"value": "8a5055c9c61122780043563ef53438e3"
},
"caller_id": {
"link": "https://instance.servicenow.com/api/now/table/sys_user/5b7c200d0a640069006b3845b5d0fa7c",
"value": "5b7c200d0a640069006b3845b5d0fa7c"
},
"knowledge": "false",
"made_sla": "true",
"comments_and_work_notes": "",
"parent_incident": "",
"state": "2",
"user_input": "",
"sys_created_on": "2015-11-02 18:05:40",
"approval_set": "",
"reassignment_count": "0",
"rfc": "",
"child_incidents": "",
"opened_at": "2015-11-02 21:58:24",
"short_description": "Can't access Exchange server - is it down?",
"order": "",
"sys_updated_by": "admin",
"resolved_by": "",
"notify": "1",
"upon_reject": "cancel",
"approval_history": "",
"problem_id": "",
"work_notes": "",
"calendar_duration": "",
"close_code": "",
"sys_id": "ef43c6d40a0a0b5700c77f9bf387afe3",
"approval": "not requested",
"caused_by": "",
"severity": "3",
"sys_created_by": "glide.maint",
"resolved_at": "",
"assigned_to": {
"link": "https://instance.servicenow.com/api/now/table/sys_user/681b365ec0a80164000fb0b05854a0cd",
"value": "681b365ec0a80164000fb0b05854a0cd"
},
"business_stc": "",
"wf_activity": "",
"sys_domain_path": "/",
"cmdb_ci": {
"link": "https://instance.servicenow.com/api/now/table/cmdb_ci/281190e3c0a8000b003f593aa3f20ca6",
"value": "281190e3c0a8000b003f593aa3f20ca6"
},
"opened_by": {
"link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint",
"value": "glide.maint"
},
"subcategory": "",
"rejection_goto": "",
"sys_class_name": "incident",
"watch_list": "",
"time_worked": "",
"contact_type": "phone",
"escalation": "3",
"comments": ""
}
}