匿名分享调用
匿名分享通过 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 就写入。
平台校验分享令牌、状态、权限、有效期、次数、系统字段和追加边界,不判断匿名内容的业务真实性。适合低信任的反馈、线索等输入;订单、支付、账号等高置信业务需由接入方另行校验。
撤销会阻止后续访问,无法收回已经保存的内容。分享地址、密码和令牌不要放入公开示例或日志。接收方网页操作见分享与外部访问。