按 ID 获取实体记录

按 ID 检索单个实体记录。

API 端点

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

• 基本 URL： https://{yourDomain}/{organizationName}/{tenantName}/dataservice_

请求标头

页眉	值
授权	承载 <access_token>

备注：

将尖括号 <...> 之间的所有值替换为其相应的用例值。

<access_token> 是您在授权外部应用程序时收到的。 它可用 1 小时，然后您需要生成新令牌，或请求刷新令牌。

路径变量

路径变量	数据类型	描述	默认值
id (Required)	string	要从 Data Service 中检索的实体记录的 ID。	不适用

查询参数

查询参数	数据类型	描述	默认值
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 或 Robot 已连接到您帐户中的新式文件夹。

403 Forbidden

您无权访问实体、字段或记录，或者您使用的机器人类型不受支持。 请联系您的管理员以获取必要的权限。