デベロッパーAPI & Webhooks

真剣にレンタル事業を行う企業であれば、遅かれ早かれプログラムでデータを入出力する必要が生じます。企業顧客がフィードを求めたり、BIツールが数値を求めたり、内部スクリプトで注文を作成したりする場合です。

Renttixはまさにそのために、バージョン管理されたREST APIを提供しています。顧客、注文、製品、およびその他のコアリソースは、/api/v1配下のクリーンなJSONエンドポイント経由で利用可能で、2バージョン前のPDFではなく、プラットフォーム自体からドキュメントが提供されます。

アクセスは、開発者ポータルで作成・管理するAPIキーで行われます。キーは即座に取り消すことができ、各キーはワークスペースにスコープ設定されているため、請負業者のノートPCにマスター認証情報が散らばることはありません。

レート制限とログ記録は、独自のインターフェースが使用するのと同じレイヤーに組み込まれているため、APIトラフィックは管理・監視可能であり、勝手な抜け道にはなりません。

変更をポーリングする統合は、早く必要な時には遅く、それ以外の時には無駄になります。Webhooksはその関係を逆転させます。何かが起こった瞬間に、Renttixがお客様のシステムに通知します。

気になるイベントのWebhookエンドポイントを登録すると、イベントが発生した際に署名されたペイロードがシステムに届きます。Webサイトから作成された注文が、確認メールが顧客に届く前にCRMに届くことも可能です。

エンドポイントは開発者ポータルでAPIキーと共に管理され、各配信がログに記録されるため、メッセージの見落としは単なる検索作業であり、謎のまま残ることはありません。

APIと共に、WebhooksはRenttixをデータをコピーして取り出す箱ではなく、構築するプラットフォームにします。システム・オブ・レコード（記録システム）はそのまま維持され、他のすべてが同期し続けます。

すべての統合には、最終的に午前3時の疑問が生じます。システムは正確に何を受け取り、何と答えたのか？

開発者ポータルはAPIトラフィックのリクエストログ（何が、どのキーで、どのような結果で呼び出されたか）を保持しているため、統合のデバッグはログを読むことになり、電話の両端からイベントを再構築する必要はありません。

同じ規律がプラットフォーム自身のアウトバウンド接続にも適用されます。会計同期、決済プロバイダーへの呼び出し、Webhook配信が記録され、すべてのシステム境界にわたって記録を残すことができます。

開発チームを持つ企業にとって、これはベンダーとプラットフォームの違いです。仕組みは検査可能で、認証情報はお客様がローテーションでき、データは別の場所で必要になった瞬間にアクセス可能です。