REST API 開発者ガイド
j少ない往復回数での複数レコードの取得
sObject コレクションを使用した GET 要求または POST 要求によって、同じオブジェクト種別の 1 件以上のレコードを取得します。指定された種別の個々のレコードを表す sObject のリストが返されます。返される sObject の数は、要求で渡される ID の数と一致します。
指定する ID が約 800 件までであれば、URL の長さが原因で HTTP 414 エラー「URI too long (URI が長すぎます)」が発生するのを回避できます。許容される URL の長さを超えるレコードを取得するには、POST 要求を使用して、同じオブジェクト種別の最大 2,000 件のレコードを取得します。POST を使用すると、取得するレコードの ID と項目はリクエストボディ内で指定されます。
要求の構文
GET 要求を使用する場合は、次の構文を使用します。ここで sObjectName はデータを取得するレコードのオブジェクト種別です。
GET /services/data/vXX.X/composite/sobjects/sObjectName?ids=recordId,recordId&fields=fieldname,fieldname
POST 要求を使用する場合は、次の構文を使用します。ここで sObjectName (必須) はデータを取得するレコードのオブジェクト種別です。
パラメータ
| パラメータ | 説明 |
|---|---|
| ids | 必須。返すオブジェクトの 1 つ以上の ID のリスト。すべての ID は同じオブジェクト種別に属している必要があります。 |
| fields | 必須。応答に含める項目のリスト。指定する項目名が有効であり、各項目の参照レベルの権限を持っている必要があります。 |
使用のガイドライン
- 無効な項目名や参照権限を持っていない項目名を指定した場合は「HTTP 400 Bad Request (HTTP 400 無効な要求)」が返されます。
- オブジェクトへのアクセス権を持っていない場合や、渡された ID が無効の場合、配列は、そのオブジェクトに null を返します。
要求の例
GET 要求を使用する場合、次の例の構文を使用します。
POST 要求を使用する場合、次の例のリクエストボディを使用します。