ストアアプリ コンテンツAPI（お知らせ・ページ・営業情報）の使い方

このガイドの目的

ストアアプリ（Web レンダラー・LINE ミニアプリ・iOS / Android アプリ）が表示するコンテンツ — お知らせ・ページ・アプリマニフェスト・営業情報・会員証設定 — を取得する /api/v1/apps/{shopId}/* の使い方をまとめます。

エンドポイント一覧

例：お知らせを取得する

{shopId} にはビジネスアカウント ID を渡します。

GET /api/v1/apps/{organizationId}/posts?status=Published&take=20

お知らせ・ページ・マニフェストはビジネスアカウント単位です。同じビジネスアカウント配下のどの店舗を選んでいても同じ内容が返ります（店舗ごとには分かれていません）。

例：営業情報を取得する（店舗単位）

営業時間だけは店舗ごとに異なるため、storeId を必須クエリで渡します。

GET /api/v1/apps/{organizationId}/business-info?storeId={storeId}&specialDaysAhead=30

storeId は GET /api/v1/me/organizations/{organizationId}/stores が返す店舗 ID です。

store → shopId の対応について

アプリは「ビジネスアカウントを選択 → 店舗を選択」という流れで、すでに organizationId と storeId の両方を保持しています。コンテンツ API には次のように渡してください。

• お知らせ・ページ・マニフェスト・会員証設定 → {shopId} に organizationId を渡す（店舗指定は不要）
• 営業情報 → {shopId} に organizationId、storeId クエリに店舗 ID を渡す

認証

コンテンツの読み取りエンドポイントは公開（コンテンツ自体が公開情報のため）で、OAuth トークンは不要です。アプリ内でビジネスアカウント ID が分かっていればそのまま呼び出せます。

お知らせの作成について

現時点で posts は読み取り専用です（API からの作成・更新エンドポイントはありません）。お知らせの編集はレシートローラーの管理画面から行います。将来、店舗スタッフがアプリからお知らせを投稿できるようにする場合は、書き込み用エンドポイントと専用スコープを別途追加します。

関連ガイド

• ビジネスアカウント・店舗・POS端末の一覧を取得する — organizationId / storeId の取得元
• 営業時間API（Business Hours API）の使い方
• 開発者ヘルプトップへ戻る