--- 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 --- # ワークプレイスコネクタ Webhook API # ワークプレイスコネクタ Webhook API {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：9分 ワークプレイスコネクタ Webhook API は、さまざまな種類のワークプレイスハードウェアまたはセンサー (バッジシステムや占有センサーなど) からのデータをワークプレイスサービスデリバリテーブルに保存できるようにする汎用インターフェイスです。 この API は `sn_wsd_wc` 名前空間で実行されます。この API にアクセスするには、ワークプレイスコネクタ (com.sn_wsd_wc) プラグインを有効にする必要があります。 この API を呼び出す前に、コネクタ構成 \[sn_wsd_wc_connector_config\] テーブルとプロバイダー構成 \[sn_wsd_wc_provider_config\] テーブルでレコードを構成する必要があります。これらのレコードを構成する方法については、「 [Configure Workplace Connectors](https://www.servicenow.com/docs/access?context=configure-workplace-connectors&version=australia&pubname=australia-employee-service-management&ft:locale=en-US)」を参照してください。 さらに、ハードウェア/センサーベースのイベントペイロードからターゲット ServiceNow テーブル (従業員参加データ \[sn_wsd_wc_employee_attendance_data\] テーブルなど) へのデータ変換/マッピングを定義する拡張ポイントを設定する必要があります。 ワークプレイスコネクタ Webhook の詳細については、「 [Workplace Connectors](https://www.servicenow.com/docs/access?context=workplace-connectors-landing-page&version=australia&pubname=australia-employee-service-management&ft:locale=en-US)」を参照してください。 ## ワークプレイスコネクタ Webhook:POST /workplace_connector_webhook/event {#ariaid-title2} コネクタイベント \[sn_wsd_wc_connector_events\] テーブルにレコードを作成し、エンドポイントのペイロードで渡されたハードウェア/センサーベースのイベントデータをそのレコードの \[ペイロード\] フィールドに保存します。 エンドポイントはペイロードを保存した後、ペイロードが処理されていないことを示すコネクタイベントレコード内の \[ステータス\] フィールドを `[新規`\] に設定します。 スケジュール済みジョブは、コネクタイベントテーブル内の新しいバッジレコードを検索し、それらを従業員参加データ \[sn_wsd_wc_employee_attendance_data\] テーブルに変換して書き込みます。\[ステータス\] フィールドは \[ `処理済み] に設定されます`。 コネクタイベントレコードのペイロードデータと従業員参加データレコードの間のデータのマッピングは、拡張ポイントで定義されます。この拡張ポイントは、関連付けられたコネクタ構成 \[sn_wsd_wc_connector_config\] テーブルの \[拡張ポイント定義\] フィールドで識別されます。このエンドポイントの場合、これは BadgingDataHandler 拡張ポイントです。 注: `処理済み`ステータスのコネクタイベントテーブルのレコードは、作成日から 2 日後に消去されます。`エラー`ステータスのレコードは、作成日から 7 日後に消去されます。`[新規`\] ステータスのレコードは消去されません。 ### URL 形式 バージョニングされた URL: /api/sn_wsd_wc/{api_version}/workplace_connector_webhook/event デフォルト URL: /api/sn_wsd_wc/workplace_connector_webhook/event 注: 使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#work_conn_web-POST-event__entry__2}{#work_conn_web-POST-event__version-not_optional-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | [表 : 1. パスパラメーター] {#work_conn_web-POST-event__entry__6} | 名前 | 説明 | |-|-| | ni.nolog.id | 必須です。イベント情報を生成したハードウェアに関連付けられたプロバイダー設定レコードのSys_id。 データタイプ：文字列 テーブル:プロバイダー構成 \[sn_wsd_wc_provider_config\] | | token_name | ユーザー名やセキュリティトークンを識別するその他の値など、セキュリティトークンの名前。要求の認証に使用されます。 データタイプ：文字列 テーブル:プロバイダー構成 \[sn_wsd_wc_provider_config\] | | token_value | パスワードなど、セキュリティトークンに関連付けられた値。要求の認証に使用されます。 データタイプ：文字列 テーブル:プロバイダー構成 \[sn_wsd_wc_provider_config\] | [表 : 2. クエリパラメーター] {#work_conn_web-POST-event__entry__14} | 名前 | 説明 | |-|-| | \<ペイロード\> | ハードウェア/センサーベースのイベントデータの名前と値のペア。 名前は、BadgingDataHandler 拡張ポイントで識別された名前に対応している必要があります。 例： { "Time zone": "(UTC-08:00) Pacific Time (US & Canada)", "Event": "Access granted", "Door": "L_SJC005_B1.101_ELEVATOR 2 INT", "Side": "Reader - In", "Cardholder": "ninat.salem", "First name": "Nina T", "Last name": "Salem", "Credential": " ninat.salem's credential", "Employee ID (Cardholder)": "10097", "Event timestamp": "11/07/2022 00:56:57" } 単一のエンドポイント呼び出し内で複数のイベントデータを渡すことができます。各イベントのデータを個別のオブジェクトに渡します。各イベントのデータは、個別の従業員出席データレコードに保存されます。 注: 日付解析の問題を回避するために、指定されたタイムスタンプが ISO 8601 形式に準拠していることを確認してください。 データタイプ:JSON オブジェクト | [表 : 3. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#work_conn_web-POST-event__entry__18}{#work_conn_web-POST-event__accept-JSON-only-entry-RESTAPI}{#work_conn_web-POST-event__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 4. 要求ヘッダー] {#work_conn_web-POST-event__entry__24} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#work_conn_web-POST-event__table_fqw_2fg_xyb__entry__2}{#work_conn_web-POST-event__entry-200-status-code}{#work_conn_web-POST-event__entry-400-status-code}{#work_conn_web-POST-event__entry-401-status-code}{#work_conn_web-POST-event__entry-404-status-code}{#work_conn_web-POST-event__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 6. ステータスコード] {#work_conn_web-POST-event__table_fqw_2fg_xyb} ### 応答本文のパラメーター {#work_conn_web-POST-event__entry__40} | 名前 | 説明 | |-|-| | エラー | データの処理中に発生したエラーの説明。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" "status": "String" } | | error.detail | エラーに関する詳細情報。 データタイプ：文字列 | | error.message | エラーメッセージ。 データタイプ：文字列 | | status | エンドポイント処理のステータス。 可能な値： * failure:エンドポイントが失敗しました。詳細については、 error オブジェクトを参照してください。 * 成功:エンドポイントが正常に完了しました。レコードが追加されました。 {#work_conn_web-POST-event__ul_lkc_q2g_xyb} データタイプ：文字列 | [ ] ### cURL 要求 次のコード例は、このエンドポイントを呼び出して、複数のカードリーダーイベントをコネクタイベントテーブルに追加する方法を示しています。要求を処理する前に、要求が認証されます。 curl http://instance.servicenow.com/api/sn_wsd_wc/v1/workplace_connector_webhook/event?token_name=token&ni.nolog.id=8e666cb0a3053110bc6e146546fcdad1&token_value=babugosha \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data --data "{ \"Time zone\": \"(UTC+02:00) Jerusalem\", \"Event\": \"Access granted\", \"Door\": \"L_TLV001_A3.07_KITCHEN AREA INT\", \"Side\": \"Reader - In\", \"Cardholder\": \" ninat.alem\", \"First name\": \" Nina T\", \"Last name\": \" Salem\", \"Credential\": \" ninat.salem's credential\", \"Employee ID (Cardholder)\": 10097, \"Event timestamp\": \"11/07/2022 10:57:24\" } { \"Time zone\": \"(UTC+02:00) Jerusalem\", \"Event\": \"Access granted\", \"Door\": \"L_TLV003_A4.07_FRONT ENT\", \"Side\": \"Reader - In\", \"Cardholder\": \" joe.blue\", \"First name\": \" Joe\", \"Last name\": \" Blue\", \"Credential\": \" joe.blue's credential\", \"Employee ID (Cardholder)\": 24098, \"Event timestamp\": \"11/07/2022 10:59:33\" }" 応答： // Successful response { "staus": "success" } // Error response { "error": { "message": "Events request is invalid. Events query parms incomplete, some fields are missing", "detail": "Missing fields: token_name, token_value" } "status": "failure" }