通过 API 将报名表单与 TakaTech 集成

当合作伙伴开展自己的活动（展会、落地页、Zalo 小程序等），并希望客户报名咨询或预约 TakaTech 产品演示时，可通过合作伙伴 API 将数据直接推送到 TakaTech 系统。

推荐架构

浏览器 / Zalo 小程序  →  合作伙伴服务器  →  POST https://takatech.vn/api/v1/leads
     （表单）           （保存 API 密钥）      （Authorization: Bearer …）

API 密钥只能保存在合作伙伴的服务器上（环境变量），不得嵌入浏览器端运行的 JavaScript 代码或小程序中。

步骤

1. 联系 TakaTech 获取 API 密钥（形如 tk_live_…）。
2. 在服务器上创建接收表单的接口，校验数据后调用 POST /api/v1/leads。
3. 在 source 字段中注明来源（例如 zalo-mini-app、landing-hoi-cho-2026），便于双方衡量效果。
4. 处理 422（数据错误）以提示用户，处理 429 以便稍后重试。

Node.js（Express）示例

app.post('/sign-up', async (req, res) => {
  const r = await fetch('https://takatech.vn/api/v1/leads', {
    method: 'POST',
    headers: { Authorization: `Bearer ${process.env.TAKATECH_API_KEY}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({ name: req.body.name, phone: req.body.phone, type: 'DEMO',
                           product: 'TakaTech ZNS Portal', source: 'zalo-mini-app' }),
  });
  const data = await r.json();
  res.status(r.status).json(data);
});

安全

• 每个合作伙伴使用独立密钥；TakaTech 可随时吊销密钥。
• 每个密钥每分钟限 60 次请求。
• 个人数据按照隐私政策处理——合作伙伴在发送前须征得用户同意。