跳到主要内容

列表查询(不分页)

V1 列值协议;直接 HTTP 调用,需要用户 Bearer 和当前请求签名。

项目内容
方法POST
路径/open-api/openapi/form/list
认证用户 Bearer + 当前请求签名 + 租户与应用上下文
请求格式application/json

调用准备​

按公共请求约定替换地址和占位值,按生成签名计算本次请求的签名。以下 JSON 保存为 UTF-8 的 request.json;签名必须使用同一份实际参数。示例为命令行 cURL;Windows PowerShell 可使用 curl.exe 并将多行命令合为一行。

请求参数​

参数类型 / 必填说明
table字符串 / 是目标表单 ID;与当前应用归属一致。
conditions对象 / 否筛选条件;建议先限定小范围。
orders、columns数组 / 对象 / 否排序和输出列。

请求示例​

request.json
{
"table": "YOUR_FORM_ID",
"conditions": {
"join": "AND",
"items": [
{
"join": "AND",
"var": "id",
"compare": 10,
"values": [
"YOUR_RECORD_ID"
]
}
]
}
}
curl --request POST "https://admin.duoge.work/api/open-api/openapi/form/list" \
--header "Authorization: Bearer YOUR_ACCESS_TOKEN" \
--header "TENANT-ID: YOUR_NUMERIC_TENANT_ID" \
--header "X-APPLICATION-ID: YOUR_APPLICATION_ID" \
--header "app_id: YOUR_APPLICATION_ID" \
--header "timestamp: CURRENT_MILLISECONDS" \
--header "signature: SIGNATURE_FOR_THIS_REQUEST" \
--header "Content-Type: application/json" \
--data-binary "@request.json"

返回说明​

本例不传 navi,成功时 data 为记录数组;无命中时为空数组。分页对象只在对应分页请求中解析,不能在此直接读取 data.records。

以下仅为相关字段的结构示意;记录字段、消息及其他属性按实际返回。

{
"code": 0,
"data": [
{
"id": "EXAMPLE_RECORD_ID"
}
]
}

使用说明与排错​

不要对大表无限制拉取;持续同步优先采用分页查询。条件结构见查询条件参考。