跳到主要内容
TakaTech

面向开发者

TakaTech Partner API v1.1.0

供合作伙伴、Zalo 小程序及外部落地页向 TakaTech 系统提交咨询请求 / 演示预约，并获取产品目录的 API。

  • 基础地址： https://takatech.vn/api/v1
  • 格式：JSON（UTF-8），符合 OpenAPI 3.1 标准——可导入 Postman、Insomnia、Swagger。
  • 支持 CORS，但 不建议在浏览器中使用 API 密钥调用；请从您的服务器 / 云函数调用。

认证

每个合作伙伴会获得一个形如 tk_live_… 的 API 密钥（请联系 TakaTech）。在请求头中发送密钥：

HTTP header
Authorization: Bearer tk_live_xxxxxxxxxxxxxxxx

密钥仅在创建时显示一次，TakaTech 以哈希形式存储，并可随时吊销。如怀疑密钥泄露，请立即告知以便更换新密钥。

限制与错误码

状态码含义
201创建成功
400请求体不是 JSON
401API 密钥缺失、错误或已吊销
422数据无效——请查看 error.details （按字段列出的错误）
429每个密钥每分钟超过 60 次请求

接口列表

post/api/v1/leads需要 API 密钥

提交咨询请求 / 演示预约

创建一条新请求，TakaTech 销售团队会立即收到通知。每个 API 密钥每分钟限 60 次请求。

get/api/v1/products公开

产品目录

TakaTech 软件产品列表（无需 API 密钥）。

get/api/v1/health公开

API 状态检查

POST /leads – 数据字段

字段类型说明
typeCONSULT | DEMO | TRAINING请求类型
name*string (≤120)联系人姓名 示例： Nguyễn Văn A
phone*string越南电话号码（0xxxxxxxxx 或 +84xxxxxxxxx） 示例： 0914586999
email电子邮箱 示例： a@donvi.vn
organizationstring (≤200)单位名称（网站表单预约演示/培训时必填） 示例： UBND phường X
servicestring (≤120)感兴趣的领域 / 服务 示例： Website & Trang thông tin điện tử
productstring (≤120)产品——type=DEMO 时必填 示例： TakaTech ZNS Portal
attendeesinteger学员人数（type=TRAINING）
messagestring (≤3000)需求内容
utmSourcestring (≤100)
utmMediumstring (≤100)
utmCampaignstring (≤100)
sourcestring (≤255)来源，例如 zalo-mini-app、landing-hoi-cho 示例： zalo-mini-app

示例

cURL
curl -X POST https://takatech.vn/api/v1/leads \
  -H "Authorization: Bearer tk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "DEMO",
    "name": "Nguyễn Văn A",
    "phone": "0914586999",
    "organization": "UBND phường X",
    "product": "TakaTech ZNS Portal",
    "source": "landing-hoi-cho"
  }'
JavaScript / Node.js
// 在您的服务器上运行（切勿在浏览器中暴露 API 密钥）
const res = 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: 'Nguyễn Văn A', phone: '0914586999', message: '需要网站建设咨询' }),
});
const body = await res.json();
if (!body.success) throw new Error(body.error.message);
const { id } = body.data;
PHP
<?php
$ch = curl_init('https://takatech.vn/api/v1/leads');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('TAKATECH_API_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Nguyễn Văn A', 'phone' => '0914586999', 'service' => 'Website & Trang thông tin điện tử',
  ]),
]);
$res = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE); // 201 = 成功
201 响应
{ "success": true, "data": { "id": "6674d02a-85f1-4e47-a427-f762338c2dd5" } }
422 响应
{ "success": false, "error": { "code": "VALIDATION_ERROR", "message": "Vui lòng kiểm tra lại thông tin.", "details": { "phone": "Số điện thoại chưa đúng định dạng" } } }

GET /products

cURL
curl https://takatech.vn/api/v1/products

返回产品列表（slug, name, tagline, audience, url），用于在您的表单中显示选项； name 值用于预约演示时的 product 字段。

Zalo