分页查询

匿名调用：分页读取表单分享允许访问的记录。

项目	内容
方法	POST
路径	/public/share/SHARE_TOKEN/page
认证	分享 Token；有访问密码时在 body 中提供 password
请求格式	application/json

调用准备

参见公共请求约定。保存下面的 JSON 为 UTF-8 的 request.json，再替换地址、令牌和字段占位值。cURL 多行示例在 PowerShell 中可改为单行 curl.exe。

请求参数

参数	类型 / 必填	说明
password	字符串 / 按分享要求	访问密码；无密码时可省略。
navi.page	整数 / 是	页码，从 1 开始。
navi.vol	整数 / 是	每页条数，示例 10。
viewId	字符串 / 否	仅能指定分享允许的视图。
conditions	对象 / 否	join / items 结构的进一步筛选。

请求示例

request.json

{
  "navi": {
    "page": 1,
    "vol": 10
  }
}

curl --request POST "https://admin.duoge.work/api/public/share/SHARE_TOKEN/page" \
  --header "Content-Type: application/json" \
  --data-binary "@request.json"

返回说明

成功时按分页结果读取 data.records、data.total 等信息；记录和字段只来自当前分享允许的范围。无命中时处理空记录集，密码或权限失败时处理错误，不能将两者混为一谈。

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

{
  "code": 0,
  "data": {
    "records": [
      {
        "id": "EXAMPLE_RECORD_ID"
      }
    ],
    "total": 1,
    "current": 1,
    "size": 10,
    "pages": 1
  }
}

使用说明与排错

有密码时在本例 JSON 加入 password。页大小字段为 vol，不能照搬旧示例的 size；conditions 不是 joinOperator / conditionItems 格式。分享 Token 自带资源、租户和应用上下文，附加条件只能缩小授权范围。不要附带管理员 Bearer 或自行指定其他表单来扩大范围。分享过期、撤销、密码错误或访问受限时，按业务提示联系分享者。查询条件见查询条件参考。