JSON データ変更 API

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：5分

    • HTTPS POST 要求をインスタンスに送信し、JSON Web サービスを使用してデータを変更します。

    HTTP POST には、実行するアクションのタイプを示す sysparm_action パラメーターを含め、受信 JSON オブジェクトを本文に post 含める必要があります。
    注:
    POST のコンテンツタイプは application/json である必要があります。application/x-www-form-urlencoded または multipart/form-data にすることはできません。

    insert

    ServiceNowで新しいレコードを作成します。JSON オブジェクトは本文として POST する必要があります (コンテンツタイプは通常 application/json ですが、強制されません)。レコード作成からの応答は、作成されたインシデントの JSON オブジェクトです。

    たとえば、次の JSON オブジェクトを投稿します。
    {"short_description":"this is a test","priority":"1"}
    次の URL に設定します。
    https://your_instance.service-now.com/incident.do?JSONv2&sysparm_action=insert

    インシデントを作成します。

    必要に応じて、JSON オブジェクトでsysparm_actionを指定することもできます。JSON オブジェクト内のパラメーターは、URL パラメーターよりも優先されます。例：
    {"sysparm_action":"insert","short_description":"this is a test","priority":"1"}

    insertMultiple

    ServiceNow で複数の新規レコードを作成するには、insert 関数の入力 JSON オブジェクトがアレイである必要があります。レコード作成からの応答は、作成されたインシデントの JSON オブジェクトです。たとえば、次の JSON オブジェクトです。
    { "records" : [ { "short_description" : "this was inserted with python using JSON 1" , "priority" : "1 - Critical" , "impact" : "1" , "caller_id" : "Fred Luddy" } , { "short_description" : "this was inserted with python using JSON 2" , "priority" : "1 - Critical" , "impact" : "1" , "caller_id" : "Fred Luddy" } ] }
    は次のいずれかの URL に投稿されました:
    https://<instance name>.service-now.com/incident.do?JSONv2&sysparm_action=insert
https://<instance name>.service-now.com/incident.do?JSONv2&sysparm_action=insertMultiple

    は 2 つのインシデントを作成します。レコードフィールドのアレイ値として記述されているフィールドに注意してください。

    update

    sysparm_query URL パラメーターで指定されたエンコードされたクエリ文字列でフィルタリングされたレコードまたはレコードリストを更新します。JSON オブジェクトは本文として投稿する必要があります (コンテンツタイプは通常 application/json ですが、強制されません)。レコード作成からの応答は、更新されたレコードを表す JSON オブジェクトのアレイです。

    たとえば、次の JSON オブジェクトを投稿します。
    {"short_description":"this was updated with python", "priority": "3", "impact":"1"}
    次の URL に設定します。
    https://instance_name.service-now.com/incident.do?JSONv2&sysparm_query=priority=3&sysparm_action=update

    優先度 3 のすべてのインシデントを更新し、JSON オブジェクトによって指定された値を設定します。

    レコードを削除

    sysparm_sys_id パラメーターで識別されるレコードを 1 つターゲットテーブルから削除します。このパラメーターは、入力 JSON オブジェクトでエンコードすることも、URL パラメーターとして指定することもできます。

    たとえば、次のように投稿します。
    {"sysparm_sys_id":"fd4001f80a0a0b380032ffa2b749927b"}
    次の URL に設定します。
    http://instance_name.service-now.com/incident.do?JSONv2&sysparm_action=deleteRecord

    sys_id fd4001f80a0a0b380032ffa2b749927b で識別されるインシデントレコードを削除します。

    deleteMultiple

    sysparm_query URL パラメーターで指定されたエンコードされたクエリ文字列でフィルタリングされた複数のレコードをターゲットテーブルから削除します。フィルターは、入力 JSON オブジェクトでエンコードすることもできます。

    たとえば、次のように投稿します。
    {"sysparm_query":"short_description=this was updated with python"}
    次の URL に設定します。
    http://instance_name.service-now.com/incident.do?JSONv2&sysparm_action=deleteMultiple

    short_descriptionフィールドに「これは Python で更新されました」という値が含まれているすべてのインシデントレコードを削除します。