开发者 API 与 Webhook

每一家认真经营的租赁企业迟早都需要以编程方式导入或导出数据——大客户想要一个数据源，BI 工具想要那些数字，内部脚本需要创建订单。

Renttix 正是为此提供了一套带版本的 REST API。客户、订单、产品以及其他核心资源都通过 /api/v1 下简洁的 JSON 端点提供，文档由平台自身提供，而不是两个版本之前的一份 PDF。

访问基于你在开发者门户中创建和管理的 API 密钥。密钥可以即时吊销，而且每个密钥都限定在你的工作区范围内——不会有一个万能凭证在某个外包人员的笔记本电脑上四处流传。

速率限制和日志记录内置于你自己界面所用的同一层，因此 API 流量是受治理、可观测的，而不是一道旁门。

通过轮询来获取变更的集成，在你需要它快时它慢，其余时间又浪费资源。Webhook 颠倒了这种关系：Renttix 在事情发生的那一刻主动告知你的系统。

为你关心的事件注册 webhook 端点，当它们触发时你的系统就会收到一份带签名的负载——从你网站创建的订单，可以在确认邮件送达客户之前就抵达你的 CRM。

端点与你的 API 密钥一起在开发者门户中管理，每一次投递都会被记录，因此一条漏掉的消息只是一次查询，而不是一个谜。

与 API 结合，webhook 让 Renttix 成为一个你在其上构建的平台，而不是一个你从中拷贝数据的盒子。记录系统仍是记录系统，其余一切保持同步。

每一个集成最终都会遇到它凌晨三点的疑问：系统究竟收到了什么，又回答了什么？

开发者门户会为 API 流量保留请求日志——调用了什么、由哪个密钥调用、结果如何——因此调试一个集成是读一份日志，而不是从一通电话的两端重建事件。

同样的纪律也适用于平台自身的出站连接。会计同步、支付服务商调用和 webhook 投递都会被记录，为你提供一条贯穿每一个系统边界的书面痕迹。

对于拥有开发团队的企业，这正是供应商与平台的区别：机制可检视，凭证由你自己轮换，数据在你需要它出现在别处的那一刻即可触达。