---
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


---

# API de roteamento do AWA

# API de roteamento do AWA {#ariaid-title1}

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

A API de roteamento do AWA fornece endpoints para rotear um documento para uma fila.
Esta API requer o plug-in Atribuição avançada de trabalho (com.glide.awa) e a função awa_integration_user.

## Roteamento de AWA - POST /now/awa/queues/{queue_sys_id}/work_item {#ariaid-title2}

Se houver um item de trabalho ativo, roteará um documento para uma fila. Se não existir um item de trabalho ativo para o documento especificado, cria um item de trabalho e define seus campos de acordo.

### Formato da URL {#awa-POST-queues-work_item__section_qgh_xt3_2mb}

URL com controle de versões: /api/now/{api_version}/awa/queues/{queue_sys_id}/work_item

URL padrão: /api/now/awa/queues/{queue_sys_id}/work_item

### Parâmetros de solicitação compatíveis

{#awa-POST-queues-work_item__entry__2}{#awa-POST-queues-work_item__version-RESTAPI}

| Nome | Descrição |
|-|-|
| api_version | Opcional. Versão do endpoint a ser acessada. Por exemplo, <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Somente especifique este valor para usar uma versão de endpoint diferente da mais recente. Tipo de dados: cadeia de caracteres |
| fila_sys_id | Sys_id do registro de fila da tabela Fila \[awa_queue\]. Tipo de dados: cadeia de caracteres |
[Tabela 1. Parâmetros de caminho]

{#awa-POST-queues-work_item__entry__8}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 2. Parâmetros de consulta]

{#awa-POST-queues-work_item__entry__12}

| Nome | Descrição |
|-|-|
| document_sys_id | Sys_id do documento a ser roteado para a fila. Tipo de dados: cadeia de caracteres |
| document_table | Nome da tabela associada ao documento, como incidente. Tipo de dados: cadeia de caracteres |
[Tabela 3. Parâmetros do corpo da solicitação (XML ou JSON)]

### 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 de REST API compatíveis](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#awa-POST-queues-work_item__entry__18}{#awa-POST-queues-work_item__accept-RESTAPI}{#awa-POST-queues-work_item__content_type-RESTAPI}

| Cabeçalho | Descrição |
|-|-|
| Aceitar | Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml. Padrão: application/json |
| Tipo de conteúdo | Formato de dados do corpo da solicitação. Tipos compatíveis: application/json ou application/xml. Padrão: application/json |
[Tabela 4. Cabeçalhos da solicitação]

{#awa-POST-queues-work_item__entry__24}

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 5. Cabeçalhos de resposta]

### Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#awa-POST-queues-work_item__entry__28}{#awa-POST-queues-work_item__entry-200-status-code}{#awa-POST-queues-work_item__entry-401-status-code}{#awa-POST-queues-work_item__entry-404-status-code}{#awa-POST-queues-work_item__entry-500-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. |
| 404 | Não encontrado. O item solicitado não foi encontrado. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 6. Códigos de status]

### Parâmetros do corpo da resposta (JSON ou XML)

{#awa-POST-queues-work_item__entry__38}

| Nome | Descrição |
|-|-|
| display_name | Nome do documento a ser roteado por este item de trabalho, como registro de caso. Tipo de dados: cadeia de caracteres |
| document_sys_id | Sys_id do documento a ser roteado para a fila. Tipo de dados: cadeia de caracteres |
| document_table | Nome da tabela associada ao documento. Tipo de dados: cadeia de caracteres |
| fila_sys_id | Sys_id da fila na qual um documento será roteado. Tipo de dados: cadeia de caracteres |
| sys_id | Sys_id do item de trabalho atribuído à fila. Tipo de dados: cadeia de caracteres |
[ ]

### Amostra de solicitação cURL

    curl -X POST \
      https://instance.servicenow.com/api/now/awa/queues/339eed3f3b892300a2bac9bb34efc4c3/work_item \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -u 'username':'password'
    -d '{
      "document_sys_id": "9c573169c611228700193229fff72400",
      "document_table": "incident"
    }'

    {
      "result": {
        "sys_id": "cd57f90ddbb26300db2051735e9619f0",
        "document_table": "incident",
        "document_sys_id": "9c573169c611228700193229fff72400",
        "queue_sys_id": "339eed3f3b892300a2bac9bb34efc4c3",
        "display_name": "Incident: INC0000001"
      }
    }