---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference
Release :
- xanadu
ft:locale :
- fr-FR
ft:publication_title :
- Référence de l’API Xanadu
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# API d'acheminement AWA
# API d'acheminement AWA {#ariaid-title1}
* Rversion finale: Xanadu
*
* Mis à jour 1 août 2024
*
*  2 minutes de lecture
L'API de routage AWA fournit des points de terminaison pour acheminer un document vers une file d'attente.
Cette API nécessite le module d'extension Affectation de travail avancée (com.glide.awa) et le rôle awa_integration_user.
## Acheminement AWA : POST /now/awa/queues/{queue_sys_id}/work_item {#ariaid-title2}
Si un élément de travail actif existe, achemine un document vers une file d'attente. Si aucun élément de travail actif n'existe pour le document spécifié, crée un élément de travail et définit ses champs en conséquence.
### Format d'URL {#awa-POST-queues-work_item__section_qgh_xt3_2mb}
URL versionnée : /api/now/{api_version}/awa/queues/{queue_sys_id}/work_item
URL par défaut : /api/now/awa/queues/{queue_sys_id}/work_item
### Paramètres de demande pris en charge
{#awa-POST-queues-work_item__entry__2}{#awa-POST-queues-work_item__version-RESTAPI}
| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| queue_sys_id | Sys_id de l'enregistrement de file d'attente à partir de la table File d'attente \[awa_queue\]. Type de données : chaîne |
[Tableau 1. Paramètres de chemin d'accès]
{#awa-POST-queues-work_item__entry__8}
| Nom | Description |
|-|-|
| Aucun | |
[Tableau 2. Paramètres de requête]
{#awa-POST-queues-work_item__entry__12}
| Nom | Description |
|-|-|
| document_sys_id | Sys_id du document à acheminer vers la file d'attente. Type de données : chaîne |
| document_table | Nom de la table associée au document, comme incident. Type de données : chaîne |
[Tableau 3. Paramètres de corps de demande (XML ou JSON)]
### En-têtes
Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#awa-POST-queues-work_item__entry__18}{#awa-POST-queues-work_item__accept-RESTAPI}{#awa-POST-queues-work_item__content_type-RESTAPI}
| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
| Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 4. En-têtes de demandes]
{#awa-POST-queues-work_item__entry__24}
| En-tête | Description |
|-|-|
| Aucun | |
[Tableau 5. En-têtes de réponses]
### Codes d'état
Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#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}
| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 404 | Introuvable. L'élément demandé est introuvable. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 6. Codes d'état]
### Paramètres du corps de réponse (JSON ou XML)
{#awa-POST-queues-work_item__entry__38}
| Nom | Description |
|-|-|
| display_name | Nom du document à acheminer par cet élément de travail, tel que l'enregistrement de ticket. Type de données : chaîne |
| document_sys_id | Sys_id du document à acheminer vers la file d'attente. Type de données : chaîne |
| document_table | Nom de la table associée au document. Type de données : chaîne |
| queue_sys_id | Sys_id de la file d'attente sur laquelle acheminer un document. Type de données : chaîne |
| sys_id | Sys_id de l'élément de travail affecté à la file d'attente. Type de données : chaîne |
[ ]
### Exemple de demande 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"
}
}