エラーコードとリトライ指針
レシートローラーAPIのエラー時のステータスコードと本文の形、トークンエンドポイントのエラー、送り直してよいケースと方法を説明します。
API認証ガイド
OAuth 2.0 認可コードフローでの認証方法を、認可URLのパラメーター、同意画面、トークン交換・取り消し、エラー、スコープまで解説します。
アカウント連携・統合API（トークン交換・/me/identities・/account/merge）
ネイティブアプリやLINEミニアプリから、LINE・Apple・GoogleのIDトークンでサインインし、ログイン方法の追加・解除とアカウントの統合を行うAPIの仕様とエラーコードです。
リダイレクトURLの設定
開発者アプリに1つ登録するリダイレクトURIの役割、完全一致のルール、環境ごとの分け方、変更の手順、よくあるエラーを解説します。
トークンが取得できない（認証エラー）
トークンエンドポイントが400/401を返すときの切り分け方。invalid_client、invalid_grant などのエラーと error_description ごとの対処を解説します。
はじめてのAPI呼び出し：アプリ登録から取引一覧の取得まで
OAuth認可コードフロー（PKCE）でトークンを取得し、ビジネスアカウントを確認して取引一覧を取得、トークンを更新するまでを通して行います。
レート制限とスロットリング
レシートローラーAPIでリクエスト数の制限があるエンドポイントと上限、429の返り方、クライアント側の流量の抑え方とリトライ方針を説明します。
エンドポイントとバージョニング
レシートローラーAPIのベースURL、バージョニング方針、廃止予告の流れ、現行バージョンの確認方法を解説します。
OAuthスコープ一覧と利用可否
レシートローラーのOAuth APIで利用できるスコープの一覧と、各スコープがどの種類のアプリに付与されるかを説明します。User系スコープの審査要件、Store系とUser系を混在できない理由、LIFFアプリからの利用方法もカバーします。
MCPでAIエージェントをレシートローラーに接続する
ClaudeをMCPコネクタとして接続する手順と、動的クライアント登録・PKCE・JSON-RPCで自作のMCPクライアントから呼び出す方法を解説します。
クライアントID・クライアントシークレットの管理
クライアントIDとクライアントシークレットの確認場所、保管のルール、漏えい時の再生成、複数環境での運用を説明します。
アクセストークンの取得と更新
アクセストークン（8時間）とリフレッシュトークン（30日）の取得・更新の手順、更新ごとの入れ替わり、使えなくなるケースを説明します。
商品マスタを自社システムと同期する
手元のCSV・JSONを読み、SKUで照合して商品を作成・差分更新するNode.jsスクリプトを、商品APIで作ります。
リクエストとレスポンスの基本（JSON）
レシートローラーAPIのリクエスト形式、必須ヘッダー、レスポンス構造、ページネーション、フィルタリング、日時形式の規則を解説します。
シークレットのローテーションと安全な保管
レシートローラーのクライアントシークレット・Webhookシークレットを安全に運用するためのローテーション計画、新旧並行期間の使い方、保管のベストプラクティスを解説します。
データ保護（匿名化・暗号化）の考え方
レシートローラー連携アプリでのデータ保護の考え方、暗号化（保管時・通信時）、匿名化・仮名化のテクニック、削除ポリシーを解説します。
商品管理API（Products API）の使い方
商品API（/api/v1/products）の一覧・取得・作成・PATCHとPUTによる更新・論理削除・画像アップロードを、項目名と注意点つきで説明します。