---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference
Release :
- xanadu
ft:locale :
- ja-JP
ft:publication_title :
- Xanadu API リファレンス
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# AWA ルーティング API
# AWA ルーティング API {#ariaid-title1}
* リリースバージョン: Xanadu
*
* 更新日 2024年08月01日
*
*  所要時間：4分
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/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#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 |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：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/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#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"
}
}