跳到主要内容

匿名分享调用

匿名分享通过 share token 解析资源、租户、应用与访问规则,不使用普通 OpenAPI 的 app_id、时间戳和业务签名。令牌只授权当前分享,不能作为管理端登录或全表查询凭据。

先确认分享上下文​

在 API 文档的 匿名调用 中,粘贴完整分享链接后可提取 Token,再按需要填访问密码。核对共享范围、视图及资源类型后调用;不要把普通工作表地址当作公开分享链接。

以下路径均相对部署的对外 API 基础地址,SHARE_TOKEN 与 RECORD_ID 必须替换。

方法与相对路径用途请求体
GET /public/share/SHARE_TOKEN公开信息与访问要求无
POST /public/share/SHARE_TOKEN/page表单分页password(按需)、navi、conditions(可选)
POST /public/share/SHARE_TOKEN/list表单列表password(按需)、conditions(可选)
POST /public/share/SHARE_TOKEN/detail/RECORD_ID允许范围内的详情password(按需)

POST 使用 Content-Type: application/json。不需要附带管理员 Bearer 或 TENANT-ID 来扩大范围,分享本身的状态和权限始终生效。

分页示例​

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

有密码时再加入 password。条件按查询协议使用 conditions 对象、join 和 items。

线上页面部分说明写作 navi.size 和 joinOperator/conditionItems;当前协议的 JSON 名为 navi.vol、join/items,本组示例使用这些字段。请求以部署对应的接口合同核对,不混用旧条件结构。

视图分享读取的是该分享允许的视图结果集,不能认为所有表单记录都开放。附加条件只能缩小允许范围;提供一个 viewId 或 recordId 不会自动取得对应资源权限。

列表与详情​

列表无额外筛选、无密码时可提交空对象;有密码时在 body 中提供。详情 ID 来自当前分享允许的记录,不沿用管理端任意查询结果。

检查业务响应和内容是否正确。分享不存在、已过期、密码错误、达到限制或已撤销时,按提示联系分享管理者;不要反复猜测令牌和密码。

匿名追加写入​

WRITE 表单分享另外提供 POST /public/share/SHARE_TOKEN/submit,仅追加单条记录,不能更新或删除已有数据。以下为提交 DTO 的结构示意:

{
"data": {"YOUR_PUBLIC_FIELD": "一条反馈"}
}

设置密码的分享按要求加入 password。只有目标分享确实允许 WRITE 且字段满足校验时才可使用;READ 分享不能因为路径换成 submit 就写入。

平台校验分享令牌、状态、权限、有效期、次数、系统字段和追加边界,不判断匿名内容的业务真实性。适合低信任的反馈、线索等输入;订单、支付、账号等高置信业务需由接入方另行校验。

撤销会阻止后续访问,无法收回已经保存的内容。分享地址、密码和令牌不要放入公开示例或日志。接收方网页操作见分享与外部访问。