api reference swagger openapi community

このガイドについて
レシートローラーの開発者向けドキュメントは複数の入り口に分かれています。それぞれの役割と使い分けを把握しておくと、必要な情報に最短で辿り着けます。

APIリファレンスとドキュメントの見方

レシートローラーの開発者向けドキュメントは、目的別に大きく4つの入り口があります。本ヘルプでは概念やユースケースを解説し、エンドポイントの正確な仕様はリファレンスで、不明点はコミュニティで、という使い分けです。

4つの入り口

入り口	用途	こんなときに
開発者ヘルプ（このサイト）	概念・利用開始・ユースケース別ガイド	「何ができるか」「どう設計するか」を理解したい
APIトップページ	よく使われるAPIの早見表とサンプル	代表的なエンドポイントをすぐに試したい
APIリファレンス（Swagger）	全エンドポイントの正確な仕様	パラメータ・レスポンス・エラーコードを正確に確認したい
開発者コミュニティ	質問・回答の蓄積、運営チームへの相談	ドキュメントで解決しない疑問・既出のFAQを探したい

いま読んでいるサイトです。概念の説明・実装方針・ユースケース別の進め方をまとめています。「特定のエンドポイントの仕様」ではなく「全体としてどう作るか」を知るためのものです。

レシートローラーAPIのトップページです。よく使われる代表的なエンドポイント（人気のAPI）を、シンプルなサンプル付きで一覧化しています。

全エンドポイントの完全なリファレンスです。OpenAPI（Swagger）仕様で生成されており、パラメータ・リクエスト本体・レスポンス本体・エラーコードまですべて確認できます。

開発者同士・運営チームと質疑応答できるコミュニティです。ドキュメントで解決しない疑問や、他の開発者が同じことで悩んでいないかを確認できます。

実際の開発フローでは、これらを組み合わせて使うのが効率的です。

レシートローラーは継続的に機能を追加しているため、まれにヘルプとリファレンスの間で記述に乖離が出ることがあります。仕様の正は常にAPIリファレンス（Swagger）です。実際のレスポンスがヘルプの記述と異なる場合は、リファレンス側を信用してください。

明らかな誤りや、改善のご提案がありましたらコミュニティまたはサポートまでお知らせください。