RevenueCatには便利なWebhook機能が存在します。
Webhookを使うことで、アプリ内課金の購入情報をサーバー（バックエンド）側でも管理することができます。
記載内容の詳細は、以下の公式ドキュメントを参照してください。
【参考記事】
前提
サーバー（バックエンド）は、FireStore以外のDBを使用していることを前提として記載。
FireStoreを使用している場合は、Webhookを使わずにFirebase Extensionを使うとより便利に同期できる。
Webhookの使用背景
- サーバー側で購入情報を管理・同期しておきたい。
- ex.) 管理画面など、スマホアプリとは別の画面で購入情報を表示したい。
- etc.
Webhookを使用する際の考慮点
主には公式ドキュメント参照。
ドキュメントを読んでよく分からなかった部分を以下抜粋。
Syncing Subscription Status
Webhooks are commonly used to sync a customer's subscription status across multiple systems. Because different webhook events contain unique information, we recommend calling theGET /subscribersREST API endpoint after receiving any webhook. That way, the customer's information is always in the same format and is easily synced to your database. This approach is simpler than writing custom logic to handle each webhook event, and has the added benefit of making your system more robust and scalable.
Webhookを受信した後、REST APIを呼び出すことが推奨されているが、最新のREST API v2 のドキュメントを参照すると、GET/subscribers というエントリは存在しない。
→ REST APIを使用する場合は v1 のREST APIを使用する必要があるとのこと。
カスタムロジックなどを作成する手間を省くために、Webhookを受信した後にREST APIを呼び出すことを推奨されている。
しかし、Webhookの共通フィールドだけを使用したい場合でもREST APIでデータを取得した方がいいのか？
→ 共通フィールドだけを使用する場合は、REST APIを使用する必要はないとのこと。
設定
Webhookの設定は、コンソールのIntegrationsからWebhookを選択してエンドポイントを貼り付けるだけ。
また、設定画面からWebhookへの手動のテスト送信も可能。
| RevenueCatコンソール | RevenueCatコンソール |
|---|---|
 |
 |
Webhookの動作確認には、Webhook.siteを使うと便利。
Webhook.siteにアクセスするとURLが自動発行されるので、それを設定画面のエンドポイント項目に貼り付けるだけでWebhookの確認ができる。
| Webhook.site起動時の画面 | Webhook受信時の画面 |
|---|---|
 |
 |
RevenueCatが送信するWebhookの中身や、Webhook発火イベントの種類についてはドキュメント参照。
終わり
Webhook.siteで動作確認ができたら、実際のサーバー側にエンドポイントを作成して、購入情報を保存する処理を実装すれば自前のサーバー側でも購入情報を管理・同期ができるようになります。
NCDC株式会社( ncdc.co.jp/ )のエンジニアチームです。 募集中のエンジニアのポジションや、採用している技術スタックの紹介などはこちら( github.com/ncdcdev/recruitment )をご覧ください！ ※エンジニア以外も記事を投稿することがあります
Discussion