APIドキュメント
レシートローラーのリテールメディアAPIを利用するための開発ガイドです。
購買データ、広告、売上、在庫、帳票などを連携し、リテールDXを支えるアプリを構築できます。
APIカタログ
購買・広告・CRM・AI・EC・店舗DXなど、すべての機能を統合したAPI群。
カテゴリ・利用対象で絞り込み、必要なAPIをすぐに探せます。
認証とアクセス
APIの利用には認証が必要です。OAuth 2.0クライアント認証方式を採用しており、 発行されたトークンを利用して各エンドポイントにアクセスします。
POST /auth/token
Content-Type: application/json
{
"client_id": "your-client-id",
"client_secret": "your-secret",
"grant_type": "client_credentials"
}
→ AccessTokenを取得
取得したトークンはリクエストヘッダに設定して利用します：
Authorization: Bearer {access_token}
リクエスト例
以下は購買データを取得するAPIの例です。 商品名、価格、購入店舗、購入日時などを取得できます。
GET /api/v1/receipts/{id}
Authorization: Bearer {access_token}
{
"store": "Example Store",
"total": 842,
"items": [
{ "name": "コーヒーM", "price": 180 },
{ "name": "サンドイッチ", "price": 420 }
],
"timestamp": "2025-11-11T10:32:45Z"
}
全エンドポイントを見る（APIリファレンス）
SDKとサンプルコード
APIの呼び出しを簡単にするSDKやサンプルコードを順次公開予定です。 Node.js / .NET / Pythonなど主要言語で、数行のコードから利用開始できます。
Webhookによるリアルタイム連携
購買や広告クリックなどのイベント発生時に、指定したURLへリアルタイムで通知します。
販促アプリや社内分析システムとの自動連携に利用できます。
POST /webhook/purchase
{
"event": "purchase.completed",
"receipt_id": "rcp-8421093",
"total": 842,
"timestamp": "2025-11-11T10:32:45Z"
}