列表查询

匿名调用：不分页读取当前分享中允许访问的小范围记录。

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

调用准备

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

请求参数

参数	类型 / 必填	说明
password	字符串 / 按分享要求	访问密码；无密码时可省略。
conditions	对象 / 否	用于收窄分享范围的筛选条件。
viewId	字符串 / 否	当前分享允许的视图 ID。

请求示例

request.json

{}

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

返回说明

成功时 data 为分享列表结果，按记录数组读取；空列表不表示密码验证失败。不要套用分页接口的 data.records 路径。

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

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

使用说明与排错

无密码、无附加条件时提交空对象；有密码时提供 password。记录较多时使用分页查询。分享 Token 自带资源、租户和应用上下文，附加条件只能缩小授权范围。不要附带管理员 Bearer 或自行指定其他表单来扩大范围。分享过期、撤销、密码错误或访问受限时，按业务提示联系分享者。查询条件见查询条件参考。