---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference
Release :
- xanadu
ft:locale :
- ko-KR
ft:publication_title :
- Xanadu API 참조
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# AWA 라우팅 API
# AWA 라우팅 API {#ariaid-title1}
* 릴리스 버전: Xanadu
*
* 업데이트 날짜 2024년 08월 01일
*
*  소요 시간: 3분
AWA 라우팅 API는 문서를 큐로 라우팅하는 엔드포인트를 제공합니다.
이 API를 사용하려면 플러그인(com.glide.awa)과 awa_integration_user 역할이 필요합니다 고급 작업 할당 .
## AWA 라우팅 - POST /now/awa/queues/{queue_sys_id}/work_item {#ariaid-title2}
활성 작업 항목이 있는 경우 문서를 큐로 라우팅합니다. 지정된 문서에 대해 활성 작업 항목이 없는 경우 작업 항목을 만들고 그에 따라 해당 필드를 설정합니다.
### URL 형식 {#awa-POST-queues-work_item__section_qgh_xt3_2mb}
버전이 지정된 URL: /api/now/{api_version}/awa/queues/{queue_sys_id}/work_item
기본 URL: /api/now/awa/queues/{queue_sys_id}/work_item
### 지원되는 요청 매개변수
{#awa-POST-queues-work_item__entry__2}{#awa-POST-queues-work_item__version-RESTAPI}
| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| queue_sys_id | 큐 \[awa_queue\] 테이블의 큐 기록 Sys_id입니다. 데이터 유형: 문자열 |
[표 1. 경로 매개변수]
{#awa-POST-queues-work_item__entry__8}
| 이름 | 설명 |
|-|-|
| 없음 | |
[표 2. 쿼리 매개변수]
{#awa-POST-queues-work_item__entry__12}
| 이름 | 설명 |
|-|-|
| document_sys_id | 큐로 라우팅할 문서의 Sys_id입니다. 데이터 유형: 문자열 |
| document_table | 문서와 연결된 테이블의 이름입니다(예: 인시던트). 데이터 유형: 문자열 |
[표 3. 요청 본문 매개변수(XML 또는 JSON)]
### 헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#awa-POST-queues-work_item__entry__18}{#awa-POST-queues-work_item__accept-RESTAPI}{#awa-POST-queues-work_item__content_type-RESTAPI}
| 헤더 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 컨텐츠-형식 | 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 4. 요청 헤더]
{#awa-POST-queues-work_item__entry__24}
| 헤더 | 설명 |
|-|-|
| 없음 | |
[표 5. 응답 헤더]
### 상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#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}
| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]
### 응답 본문 매개변수(JSON 또는 XML)
{#awa-POST-queues-work_item__entry__38}
| 이름 | 설명 |
|-|-|
| display_name | 케이스 기록과 같이 이 작업 항목으로 라우팅할 문서의 이름입니다. 데이터 유형: 문자열 |
| document_sys_id | 큐로 라우팅할 문서의 Sys_id입니다. 데이터 유형: 문자열 |
| document_table | 문서와 연결된 테이블의 이름입니다. 데이터 유형: 문자열 |
| queue_sys_id | 문서를 라우팅할 큐의 Sys_id입니다. 데이터 유형: 문자열 |
| sys_id | 큐에 할당된 작업 항목의 Sys_id입니다. 데이터 유형: 문자열 |
[ ]
### 샘플 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"
}
}