---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# AWA ルーティング API

# AWA ルーティング API {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：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  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| queue_sys_id | キューレコードのSys_id。 データタイプ：文字列 テーブル:キュー \[awa_queue\] |
[表 : 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/lLW_uT5I5_l1aD8yR4Jt9A "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/lLW_uT5I5_l1aD8yR4Jt9A "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"
      }
    }