カスタムストアAPI  /  個人情報・検収

個人情報・検収チェックリスト

個人情報

• 所有者と一致しない注文・配送・会員の情報は、絶対に返さないでください（404）。
• 必要なフィールドだけを送ってください。カード・口座・住民登録番号・パスワード・管理者メモは送りません。
• buyer・receivers・会員の氏名・電話番号・メールアドレスはマスキングしてください（例：ki***@example.com、010-****-5821）。Cafe24のレスポンスをそのまま渡さないでください。
• APIキーはログに残さず、コンソールで「発行 → 切り替え」の2ステップで交換します。切り替えるまでは以前のキーも有効です。

検収チェックリスト

v1.0

• キーがない、または誤っている → 401
• /v1/ordersに所有者（member_id・buyer_cellphone）がない → 400
• 他人の注文 → 404、本人の注文 → 200
• limitが50超なら50に制限し、next_cursorで最後まで巡回できる
• IDと金額は文字列、金額にはcurrency、日時はISO 8601
• フィールド名はCafe24と同じで、商品明細のorder_statusはCafe24コード
• 商品明細のimageは空でない絶対https URL（オプションの写真がなければ商品の代表画像）
• コンソールの［接続テスト］に合格（capabilitiesが200または404）

v1.1

• capabilitiesで有効にした機能のエンドポイントがすべて200（無効の機能は404でも可）
• 同じIdempotency-Keyで2回書き込むと、2回目は実行せずに同じレスポンス。本文が異なれば409 idempotency_conflict
• 配送中（N30）の注文のキャンセル → 409 not_allowed_in_state、出荷前 → 200＋C00
• 他人の注文にmember_idを入れて書き込む → 404
• エラー本文は{ "error": { "code", "message" } }
• since_product_noの一覧は番号の昇順、非表示の商品を含み、最後のページはlimitより少ない

［接続テスト］は/v1/capabilitiesのみを確認します。注文・会員のレスポンス形式は、このドキュメントの例と比べて直接ご確認ください。書き込みの確認は必ずテスト注文で行ってください。