エンティティ レコードを ID で取得

単一のエンティティ レコードを ID で取得します。

API エンドポイント

BaseURL/EntityService/<Entity>/read/{id}

• ベースURL: https://{yourDomain}/{organizationName}/{tenantName}/dataservice_

要求ヘッダー

ヘッダー	値 (Value)
認可	Bearer <access_token>

注:

角括弧で囲まれた値 <...> をすべて、対応するユース ケース値に置き換えます。

<access_token> は、外部アプリケーションの認証時に受け取ったトークンです。このトークンは 1 時間利用可能です。1 時間経ったら、新しいトークンを生成するか、更新トークンを要求する必要があります。

Path 変数

Path 変数	データ型	説明	既定値
id (Required)	string	Data Service から取得するエンティティのレコードの ID です。	NA

Query Parameters

クエリ パラメーター	データ型	説明	既定値
expansionLevel (任意)	int32	取得する関連レコードの深さを指定します。このパラメーターには 1、2、または 3 のいずれかの値を指定できます。	2

応答

200 OK

{
  "ClosingDate": "2021-03-04",
  "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "CreateTime": "2021-03-04T10:20:24.485Z",
  "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Logo": {
    "Name": "string",
    "Path": "string",
    "Size": 0,
    "Type": "string"
  },
  "Name": "string",
  "Nations": 0,
  "OlymipcsVersion": 0,
  "OpeningDate": "2021-03-04",
  "UpdatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "UpdateTime": "2021-03-04T10:20:24.485Z"
}

401 未承認

Data Service へのアクセスが認証されていません。お使いのアカウントのモダン フォルダーに Assistant またはロボットが接続されていることをご確認ください。

403 Forbidden

エンティティ、フィールド、またはレコードにアクセスする権限がありません。または、サポートされていない種類のロボットを使用しています。必要な権限について管理者にお問い合わせください。