获取单条填表实例详情新版SDK
更新于 2023-01-18
例如，测试一次性填表表单共有3条回复数据，如下图所示。
调用本接口可以根据某条回复数据的实例ID，获取该条回复实例内的表单详情信息，包括填表实例提交时间、表单实例提交者userId等。
权限
要调用此API，需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 支持 | 智能填表数据读取权限 | API Explorer |
| 第三方企业应用 | 支持 | 智能填表数据读取权限 | API Explorer |
| 第三方个人应用 | 暂不支持 | 智能填表数据读取权限 | 暂不支持 |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Path参数
Query参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
bizType | Integer | 否 | 填表类型。
|
返回参数
名称 | 类型 | 描述 |
|---|---|---|
success | Boolean | 接口调用是否成功。
|
result | Object | 返回结果。 |
createTime | String | 填表实例提交时间，iso8601格式，例如2022-07-29T15:07Z。 |
modifyTime | String | 填表更新时间，iso8601格式，例如2022-07-29T15:07Z。 |
formCode | String | 表单模版code。 |
title | String | 表单名称。 |
creator | String | 表单实例提交者userId。 |
forms | Array | 表单内容列表。 |
label | String | 表单控件名称。 |
key | String | 表单控件key。 |
value | String | 表单控件的值。 |
示例
请求示例
返回示例
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | swform.getFormInstance.paramError | invalid biz_type | 填表类型参数非法，当前仅支持0：通用智能填表 1：教育版填表 |
400 | swform.getFormInstance.paramError | invalid formInstanceId | formInstanceId请求参数不能为空 |
400 | swform.getFormInstance.paramError | param invalid | 获取填表实例详情参数异常 |
400 | swform.getFormInstance.paramError | app not exist | 应用不存在 |
400 | swform.getFormInstance.paramError | app has been stoped | 应用已停用 |
400 | swform.getFormInstance.paramError | can't find form app | 找不到应用（不存在或已停用） |
400 | swform.getFormInstance.bizError | getInstance fail | 获取表单详情失败 |
500 | swform.getFormInstance.sysError | swform.getFormInstance.sysError | 获取填表实例详情系统异常 |
