商品マスタを自社システムと同期する
手元のCSV・JSONを読み、SKUで照合して商品を作成・差分更新するNode.jsスクリプトを、商品APIで作ります。
店舗の予約を自社のカレンダーに表示する
予約管理APIで店舗の7日分の予約を取得し、Node.jsでiCalendar(.ics)ファイルに書き出してカレンダーに表示する手順です。
予約管理API(Reservations API)の使い方
予約管理APIで予約の取得・作成・変更・時間変更、予約枠の生成、メニューの空き時刻、予約設定、席、月次件数を扱う方法です。
Webhookの概要
実際に送信されるWebhookイベント、届くリクエストの形と署名ヘッダー、重複・順序・取りこぼしの扱い、APIとの使い分けを説明します。
レート制限とスロットリング
レシートローラーAPIでリクエスト数の制限があるエンドポイントと上限、429の返り方、クライアント側の流量の抑え方とリトライ方針を説明します。
エラーコードとリトライ指針
レシートローラーAPIのエラー時のステータスコードと本文の形、トークンエンドポイントのエラー、送り直してよいケースと方法を説明します。
User系スコープでapp_not_approvedが返る
User系スコープを使うとapp_not_approvedエラーが返る場合の確認手順。サンドボックス枠での開発、審査申請、サンドボックス本番化の流れを解説します。
署名検証とセキュリティ
X-RR-Signatureの計算方法とNode.js・Python・C#の検証コード、リプレイへの備え、Webhookシークレットの入れ替え方を説明します。
在庫データ連携
レシートローラーの在庫データの構造、複数倉庫管理、入出庫履歴、Webhookによるリアルタイム同期、WMS連携パターンを解説します。
購買・レシートデータ連携
レシートローラーが扱う購買・レシートデータの構造、取得方法、関連スコープ、Webhook、よくあるユースケースを解説します。
アプリを新規作成する
ビジネスアカウントに開発者アプリを登録する手順を、入力項目、クレデンシャルの表示、作成後にできること、よくあるつまずきまで説明します。
Webhookが届かない
Webhookが届かないときに、テスト送信と配信ログで原因を切り分け、無効化・購読イベント・接続・署名検証を順に確認する手順です。
監視と失敗時の対応
Webhookの有効状態・最終送信日時・配信ログの見方と、自動で無効になったことに気づいて復旧し、抜けた期間をAPIで補う方法を説明します。
アクセス制御と監査ログ
レシートローラー連携アプリ運用におけるアクセス制御の設計、最小権限、監査ログの取り方、定期レビューの実施方法を解説します。
アクセストークンの取得と更新
アクセストークン(8時間)とリフレッシュトークン(30日)の取得・更新の手順、更新ごとの入れ替わり、使えなくなるケースを説明します。
クライアントID・クライアントシークレットの管理
クライアントIDとクライアントシークレットの確認場所、保管のルール、漏えい時の再生成、複数環境での運用を説明します。
SLA・稼働率と障害時の確認手順
レシートローラーAPIの稼働率目標、ステータスページの確認方法、障害発生時の切り分け手順、サポートエスカレーションの流れを解説します。
403/401が返る(権限・スコープ)
API呼び出しで401や403が返るときの原因切り分け。トークン無効・スコープ不足・店舗アクセス権なし・User系審査未通過などの典型ケースを解説します。
データ保護(匿名化・暗号化)の考え方
レシートローラー連携アプリでのデータ保護の考え方、暗号化(保管時・通信時)、匿名化・仮名化のテクニック、削除ポリシーを解説します。
商品管理API(Products API)の使い方
商品API(/api/v1/products)の一覧・取得・作成・PATCHとPUTによる更新・論理削除・画像アップロードを、項目名と注意点つきで説明します。