开发者中心

申请新应用
应用AppKeyAppSecretQPS日限额状态操作
{{ a.app_name }} {{ a.app_key }} {{ a.app_secret ? a.app_secret : '—（未通过审核）' }} {{ a.qps_limit }} {{ a.daily_limit }} {{ statusText(a.status) }}
暂无应用，提交申请后由管理员审核
调用日志（最近 100 条）
时间方法接口状态码IP
{{ l.created_at }}{{ l.method }}{{ l.endpoint }}{{ l.response_code }}{{ l.ip_address }}
配置 Webhook
第三方往生成的链接 POST 数据即可回传，无需填写地址
接收模式：平台生成专属链接，第三方往该链接 POST JSON 数据，数据自动解析并保存为问卷答卷（可在统计页查看）。推送模式：平台在新答卷等事件时向回调地址推送数据，失败按 1m/5m/15m/1h/4h 退避重试最多 5 次。
Webhook #{{ w.id }} {{ w.mode==='inbound' ? '接收' : '推送' }} · {{ w.url }}
接收链接
第三方通过 POST 向此链接发送 JSON 数据，数据将自动解析并保存为问卷答卷（可在统计页查看），同时记录在推送日志中。
回调数据格式（结合问卷「{{ w.survey.title }}」共 {{ w.survey.questions.length }} 题）
{{ w.callbackExample }}
将上述 JSON POST 到接收链接即可完成数据回传并自动入库；answers[].question_ukey 对应各题目，value 为答案值。提交后可在问卷统计页查看该答卷。
平台推送数据格式（触发：新答卷 / {{ w.survey ? w.survey.title : '' }}）
{{ w.pushExample }}
时间答卷状态响应码重试错误信息操作
{{ l.sent_at }} {{ l.response_id }} {{ l.status }} {{ l.response_code || '-' }} {{ l.retry_count }} {{ l.error_message || '-' }}
暂无推送记录
签名认证说明

所有 API 请求需携带以下请求头进行 HMAC-SHA256 签名认证：

请求头说明示例
X-App-Key应用密钥（审核通过后获得）abc123def456
X-TimestampUnix 时间戳（秒），与服务器差 ≤5 分钟1724500000
X-Nonce随机字符串（每次请求不同）a1b2c3d4e5f6
X-SignHMAC-SHA256 签名值见下方算法
签名算法
message = HTTP方法 + "\n" + 请求路径 + "\n" + 时间戳 + "\n" + Nonce + "\n" + 请求体
sign = HMAC-SHA256(AppSecret, message)
错误码
错误码说明
4001缺少签名参数 / 应用未审核通过
4002时间戳过期或格式错误
4003重复请求（Nonce 已使用）
4004签名校验失败
4290QPS 超限
4291日调用量超限
接口列表
方法路径说明认证
POST/api/v1/surveys创建问卷签名
GET/api/v1/surveys查询问卷列表签名
PUT/api/v1/surveys/{id}更新问卷签名
DELETE/api/v1/surveys/{id}删除问卷签名
POST/api/v1/surveys/{id}/publish发布问卷签名
POST/api/v1/responses提交答卷签名
GET/api/v1/responses/{id}查询答卷详情签名
GET/api/v1/responses/export导出答卷 CSV签名
POST/api/v1/files/upload上传文件签名
POST/api/v1/webhooks配置 Webhook签名
GET/api/v1/webhooks/{id}/logsWebhook 日志签名
签名示例
在线调试（Swagger UI）
查看 JSON
正在加载 API 在线调试工具...
若长时间未加载，可查看上方完整的接口列表与签名规范
✕
未授权

{{ errorMsg }}