合作伙伴门户

如何在这里发生某件事的瞬间通知外部系统。您为某个事件订阅一个地址,平台就会开始调用它——并记录每次投递。

租户登记一个端点(您的一个 URL),以便每当 Tenka 中发生业务事件时——合同签署、票据付款、FCA 开立——通过 HTTP 收到通知。每条通知都是一个 POST,用只有您和 Tenka 知道的密钥对请求体做 HMAC-SHA256 签名(请求头 X-Tenka-Signature):您的系统验证签名,就能确认调用来自 Tenka 且未被篡改。在这里您可以创建订阅(url + 事件 + 密钥)、启用/停用、跟踪投递记录(待处理 → 已投递 | 失败,附尝试次数和退避),还可以触发测试事件或将失败的投递重新入队。事件"*"订阅全部事件。它不同于内部计费 webhook(Asaas)。

每次投递都用订阅的密钥签名。接收方必须在信任内容之前验证该签名——否则任何知道您 URL 的人都能向它发送伪造事件。

测试按钮会立即向您的端点发送一个真实事件,无需等待实际情况发生。这是发现 URL、防火墙或签名错误的最快方法——赶在第一个真实事件在队列中丢失之前。

A API pública /api/v1 é congelada: nada some nem muda de tipo; mudança que quebra vai para /v2. O SDK sai do próprio contrato: /api/v1/sdk/tenka.js e /api/v1/sdk/tenka.py. O histórico de versões está no documento API-CHANGELOG da Biblioteca.

端点宕机不会丢失事件:平台会重试,并逐步拉开重试间隔。记录会显示状态和尝试次数——正是在那里,您会发现集成"停了"是因为对方的证书过期。

O log de eventos mostra tudo que a conta enviou, em todas as inscrições, com filtro por evento e situação. Reenviar cria uma entrega nova com o mesmo conteúdo e o cabeçalho X-Tenka-Replay-Of com o id da original, para o sistema que recebe não duplicar. Toda entrega leva X-Tenka-Event-Version com a versão do contrato.

发生事情时,Tenka 会通知我的哪些系统——投递是否送达?为每个业务事件登记一个端点(您的一个 URL),Tenka 就会发送一个对请求体做 HMAC-SHA256 签名的 POST(请求头 X-Tenka-Signature),您的系统据此验证调用来自这里且未被篡改。投递记录显示待处理、已投递或失败,并附尝试次数和退避;可以触发测试事件,也可以将失败的投递重新入队。事件 * 会为该端点订阅所有事件。