文档中心 · 产品指南与开放平台

DaoTu Tech 文档中心

抽奖、海报、问卷的产品上手说明,以及 Webhook / Open API 对接文档,便于把互动数据回流到自建系统。

99.99%企业级高可用 SLA
<500ms接口与 Webhook 延迟
5 次投递失败自动重试
~180ms海报动态合成延时
产品上手

快速创建一场活动

面向运营与产品:可视化配置抽奖、海报或问卷,绑定企业自有公众号 / 小程序后即可发布。

  • 抽奖玩法与奖池、中奖率可配置
  • 绑定企业自有微信公众号 / 小程序
  • 海报与问卷可配置后直接投放
查看产品指南
接口文档
开放平台

Open API 接口文档

开通第三方应用后,可查询抽奖记录、参与人、问卷答卷、投票记录等业务数据,对接自建系统或 CRM。

AppId / AppSecretHMAC 签名在线文档
点击进入接口文档,可查阅鉴权说明、业务接口与 Webhook 推送说明。
进入 API 文档 ↗
事件推送

Webhook 事件推送

中奖、问卷提交、投票提交等事件可推送到企业回调地址;典型投递延迟 <500ms,失败自动重试。

  • 与主动查询相同的 HMAC 签名
  • 失败重试最多 5 次(指数退避)
  • 可查看投递报文与响应状态
查阅 Webhook 说明
PRODUCT GUIDES

核心产品与上手指南

抽奖、邀请函、海报、问卷、投票的配置要点,以及开放平台可回传的数据能力。

活动邀请函

智能邀请函

与海报共用同一套编辑器,组件有所区分;最终为可翻页的多页 HTML,可交互操作。

查阅邀请函相关 Open API
裂变海报

裂变海报

与邀请函共用编辑器;仅单页配置,云端合成图片,可注入动态字段与带参二维码。

查阅海报相关 Open API
INTEGRATION EXAMPLES

Webhook 验签与对接示例

平台提供签名算法说明与多语言示例代码,可按文档自行对接;不依赖官方 SDK 包。开放 API 文档内含 Node.js / Java / C# 签名示例。

webhook_verify.js
const crypto = require('crypto');
const express = require('express');
const app = express();
app.use(express.json());
// AppSecret 仅本地保存,不会出现在推送中
const APP_SECRET = process.env.DAOTU_APP_SECRET;
app.post('/api/webhook/daotu', (req, res) => {
const appId = req.headers['x-app-id'];
const timestamp = req.headers['x-timestamp'];
const nonce = req.headers['x-nonce'];
const signature = req.headers['x-signature'];
const expected = crypto
.createHmac('sha256', APP_SECRET)
.update(String(appId) + String(timestamp) + String(nonce))
.digest('hex');
if (signature !== expected) {
return res.status(401).json({ error: 'Invalid Signature' });
}
const { event_type, data } = req.body;
console.log(`收到事件: [${event_type}]`, data);
res.status(200).json({ received: true });
});
Endpoint Status: 200 OK (Latency: 28ms)查阅完整说明 ↗
FAQ

常见对接问题

鉴权、验签、限流与数据回流的常用说明。

开放 API 的调用频率限制是多少?

默认按应用限制为每分钟 60 次请求。可在开放应用配置中调整;也可配置 IP 白名单,未配置则不限制来源 IP。

Webhook 如何验签?如何降低重放风险?

推送 Header 含 X-App-Id、X-Timestamp、X-Nonce、X-Signature、X-Event-Id。验签与主动查询相同:HMAC-SHA256(AppSecret, AppId+Timestamp+Nonce) 小写 hex。AppSecret 不会出现在推送中,请用本地保存的密钥验签;建议校验时间戳并用 X-Event-Id 去重。

开放 API 如何鉴权?

开通第三方应用后获得 AppId / AppSecret。每次请求携带 X-App-Id、X-Timestamp、X-Nonce、X-Signature;签名原文为 AppId + Timestamp + Nonce,算法为 HMAC-SHA256,时间戳偏差不超过 5 分钟。AppSecret 仅开通/重置时展示一次。

如何把互动数据接到自建 CRM?

配置 Webhook 回调地址接收业务事件;或通过 Open API 分页查询抽奖记录、参与人、问卷答卷、投票记录。同一开放应用可覆盖活动 / 海报 / 问卷(含投票)。

企业级 99.99% SLA · Webhook / Open API

准备好对接了吗?

查阅接口文档完成鉴权与事件接收;如需协助,可扫码联系技术咨询。

进入 API 文档 ↗