リソース / Webhooks

リアルタイムイベント通知

Laabamアカウントでイベントが発生したときに即時通知を受信

リアルタイム

イベント発生時に即時通知を受信

信頼性

指数バックオフによる自動リトライ

監視

配信ステータスを追跡し、問題をデバッグ

利用可能なイベント

invoice.created

新しい請求書が作成されたときにトリガー

ペイロード例:

{
  "invoice_id": "inv_123",
  "status": "draft",
  "amount": 50000
}
invoice.paid

請求書の支払いが受領されたときにトリガー

ペイロード例:

{
  "invoice_id": "inv_123",
  "payment_id": "pay_456",
  "amount": 50000
}
customer.created

新しい顧客が追加されたときにトリガー

ペイロード例:

{
  "customer_id": "cust_789",
  "name": "John Doe",
  "email": "john@example.com"
}
payment.failed

支払い試行が失敗したときにトリガー

ペイロード例:

{
  "payment_id": "pay_456",
  "reason": "insufficient_funds"
}

実装例

アプリケーションでWebhookを処理する方法:

// Webhook endpoint example (Node.js/Express)
const express = require('express');
const app = express();

app.post('/webhooks/laabam', express.json(), (req, res) => {
  const event = req.body;
  
  // Verify webhook signature
  const signature = req.headers['x-laabam-signature'];
  if (!verifySignature(signature, req.body)) {
    return res.status(401).send('Invalid signature');
  }
  
  // Handle different event types
  switch (event.type) {
    case 'invoice.created':
      console.log('New invoice:', event.data.invoice_id);
      // Your business logic here
      break;
      
    case 'invoice.paid':
      console.log('Payment received:', event.data.payment_id);
      // Update your database, send email, etc.
      break;
  }
  
  res.status(200).send('Webhook received');
});

あなたのWebhooks

https://api.yoursite.com/webhooks/laabam
アクティブ
invoice.createdinvoice.paid

最終配信

2分前

成功率

99.8%

https://staging.yoursite.com/webhooks
アクティブ
customer.createdpayment.failed

最終配信

15分前

成功率

100%

Webhookのベストプラクティス

  • 信頼性を確保するために常にWebhook署名を検証
  • 受信を確認するために迅速に200ステータスコードを返す
  • キュー内でWebhookデータを非同期に処理
  • データセキュリティを確保するためにHTTPSエンドポイントを使用
  • 重複イベントを処理するためにべき等性を実装

Webhooksの使用を開始

Laabam Webhookでリアルタイム統合を構築