追加提交(WRITE 分享)
匿名调用:向允许 WRITE 的表单分享追加单条记录。
| 项目 | 内容 |
|---|---|
| 方法 | POST |
| 路径 | /public/share/SHARE_TOKEN/submit |
| 认证 | 分享 Token;有访问密码时在 body 中提供 password |
| 请求格式 | application/json |
调用准备
参见公共请求约定。保存下面的 JSON 为 UTF-8 的 request.json,再替换地址、令牌和字段占位值。cURL 多行示例在 PowerShell 中可改为单行 curl.exe。
请求参数
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
| password | 字符串 / 按分享要求 | 访问密码;无密码时可省略。 |
| data | 对象 / 是 | 键为当前分享表单 formSettings.field,值遵循组件协议。 |
请求示例
request.json
{
"data": {
"YOUR_PUBLIC_FIELD": "一条反馈"
}
}
curl --request POST "https://admin.duoge.work/api/public/share/SHARE_TOKEN/submit" \
--header "Content-Type: application/json" \
--data-binary "@request.json"
返回说明
外层为业务响应包装,data 内为提交结果,包含 success 和 result;result 是实际写入结果。需要同时检查外层业务状态与提交结果,不能把 HTTP 200 当作保存成功。
以下仅为相关字段的结构示意;记录字段、消息及其他属性按实际返回。
{
"code": 0,
"data": {
"success": true,
"result": {}
}
}
使用说明与排错
仅允许单条 append-only 新增,不能更新或删除。READ 分享不能通过换成 submit 路径写入。系统字段、分享状态、有效期、次数和提交字段仍受校验。
平台不判断匿名内容的业务真实性;适合公开反馈、线索等低信任输入。订单、支付、账号等高置信业务由接入方自行做业务校验和可信度治理。提交超时先确认结果,避免重复追加。