跳到主要内容

追加提交(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 路径写入。系统字段、分享状态、有效期、次数和提交字段仍受校验。

平台不判断匿名内容的业务真实性;适合公开反馈、线索等低信任输入。订单、支付、账号等高置信业务由接入方自行做业务校验和可信度治理。提交超时先确认结果,避免重复追加。