获取记录详情

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

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

调用准备

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

请求参数

参数	类型 / 必填	说明
table	字符串 / 是	目标表单 ID；与当前应用归属一致。
conditions	对象 / 是	限定目标记录；使用 join / items / var / compare / values。

请求示例

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/detail" \
  --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 决定返回形态：本例未传 navi，data 为匹配记录数组。使用 ID 等值条件后应检查恰好命中一条，再取该条记录。不要仅凭接口名假定 data 一定是单个对象。无记录时处理空结果。

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

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

使用说明与排错

记录 ID 从当前授权范围的列表取得。此接口仍使用条件体，不能仿照匿名详情把记录 ID 拼入 URL。示例 compare=10 表示标量等值；values 即使一个值也必须是数组。