Tallker API v1

联系人 API

连接服务器系统,传递联系人和订单,并安全识别组件中的已登录用户。

身份验证与权限

API 密钥只能保存在服务器。浏览器中只能使用短期 identity token。

fetch("https://tallker.com/api/v1/public/contacts/upsert", {
  method: "POST", headers: { Authorization: "Bearer " + process.env.TALLKER_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ external_id: "customer_18452", name: "Ivan", email: "ivan@example.com" })
});

速率限制与幂等性

120 requests / minute · HTTP 429 · Retry-After · Idempotency-Key 24h

示例

curl · JavaScript · PHP

安全

API 密钥只能保存在服务器。浏览器中只能使用短期 identity token。

OpenAPI 3.1