列表查询(不分页)
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"
}
]
}