---
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


---

# JSONv2 Web サービス

# JSONv2 Web サービス {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：1分

JavaScript 言語の発展による自然な結果として、JSON 形式でデータセットを記述する機能が備わりました。

ServiceNow は、データの入出力形式として JSON オブジェクトで動作する Web サービスインターフェイスをサポートしています。  
JSONv2 Web サービスは、SOAP、WSDL、CSV、Excel、および XML のサービスと同様のプラットフォームレベルのプロセッサーによって提供されます。これらのサービスと同様に、JSON Web サービスはスタンドアロンの JSONv2 URL パラメーターによってトリガーされます。例：

    https://<instance name>.service-now.com/mytable.do?JSONv2

JSON オブジェクトを Web サービスのデータ形式として使用できるということは、JSON オブジェクト形式を使用してシステム内のデータを作成 (挿入)、更新、およびクエリし、結果を JSON オブジェクト形式で取得できることを意味します。

## セキュリティ

プラットフォームで利用可能な他のすべての HTTP ベースの Web サービスと同様に、JSONv2 Web サービスは、デフォルトで基本認証を使用して認証する必要があります。認証に使用されるユーザー ID は、インタラクティブユーザーと同じ方法でアクセス制御されます。
* **[JSON オブジェクト形式](https://servicenow-prod.fluidtopics.net/B_VYfN_0rSWOIS_8GIXtEw)**   
  JSON オブジェクトは 2 つの構造で構築されています。
* **[JSON 応答ステータス](https://servicenow-prod.fluidtopics.net/wr8SSTIWS65QI_8bQm6k5A)**   
  JSONv2 要求は、いくつかの応答ステータスのいずれかを返す場合があります。
* **[返される行数の設定](https://servicenow-prod.fluidtopics.net/2UOHq5Be_UNswPArOTPHmg)**   
  次のシステムプロパティは、JSON が各クエリで返す行数を制御します。
* **[着信 JSONv2 要求に対する基本認証の要求](https://servicenow-prod.fluidtopics.net/JeVO__8j0NtBaCpzEEaMIw)**   
  次のシステムプロパティは、着信 JSONv2 要求に基本認証が必要かどうかを制御します。
* **[アクションパラメーター](https://servicenow-prod.fluidtopics.net/wTdgGunbCTg249FW3Y_s0g)**   
  アクションパラメーターは、JSON オブジェクトパラメーターが HTTP GET または POST 要求の一部である場合に実行するアクションを指定するため、データパラメーターから分離され、異なるものになっています。
* **[JSON データ検索 API](https://servicenow-prod.fluidtopics.net/aoqBc2bM~LMP8SGywBoLuA)**   
  インスタンスに HTTPS GET 要求を発行して、データをクエリします。
* **[JSON データ変更 API](https://servicenow-prod.fluidtopics.net/F3MLxVArJWhPZgZTj1WaAA)**   
  HTTPS POST 要求をインスタンスに送信し、JSON Web サービスを使用してデータを変更します。

**関連概念**   

* [SOAP Web サービスのセキュリティ](https://servicenow-prod.fluidtopics.net/idzkKOkCs_8FmgZ7aZEUxQ "Simple Object Access Protocol (SOAP) は、HTTP 経由で Web サービスにアクセスするための XML ベースのプロトコルです。")