POST /api/v1/query
この API は、データモデルオブジェクト、レイクオブジェクト、統合オブジェクト、リンクされたオブジェクト全体で Salesforce CDP データレイクを照会します。
構文
- HTTP のメソッド
- POST
- 使用可能なバージョン
- Salesforce CDP v1.0、Salesforce v51.0
- 形式
- REST
- URI
- /api/v1/query
要求パラメータ
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| limit | int | 返すレコード数。例: 10 |
| offset | int | 結果を返す最初の行までスキップする行数。例: 100 |
| orderby | string | 結果セットを昇順または降順に並び替えるための値のカンマ区切りリスト。例: GenderId__c ASC,Occupation__c DESC |
例
- 要求
-
1{ 2 "sql": "select BirthDate__c, DataSourceId__c, DataSourceObjectId__c, ExternalRecordId__c, FirstName__c, GenderId__c, Id__c, InternalOrganizationId__c, LastName__c from Individual__dlm where Id__c='100470169'” 3 } - 応答
-
1{ 2 "data": [ 3 { 4 "Id__c": "100470169", 5 "GenderId__c": "M", 6 "FirstName__c": "Joshua", 7 "LastName__c": "Carrier", 8 "BirthDate__c": "1994-01-21T00:00:00", 9 "ExternalRecordId__c": "003f200002a3227163", 10 "DataSourceId__c": "SubscribedUsers", 11 "InternalOrganizationId__c": "", 12 "DataSourceObjectId__c": "Subscribers_for_CDP" 13 } 14 ], 15 "startTime": "2020-12-19T06:50:05.251Z", 16 "endTime": "2020-12-19T06:50:05.251Z", 17 "rowCount": 1, 18 "queryId": "3442db1a-ecef-42b3-b0d8-971ee459efa4" 19}
HTTP 応答
| 応答 | 理由 |
|---|---|
| 200 OK | コールバックが正常に検証されました。 |
| 400 Bad Request | 無効な要求です。 |
| 403 Forbidden | 承認の受け渡しに失敗しました。 |
| 404 Not Found | コールバック ID または検証キー、あるいはその両方が正しくありません。 |
| 422 Unprocessable Entity | 項目/検索条件パラメータで使用されている属性名が存在しません。 |
| 500 Server Error | 内部エラーです。 |