カスタムストアAPI / 注文照会

注文照会

お客様が注文や配送について尋ねると、LIAはこのAPIで注文を探します。他のお客様の注文が混ざらないよう、すべての注文照会には所有者（会員IDまたは注文者の携帯電話番号）が付きます。

注文一覧

GET/v1/orders

新しい注文から順に返し、ページはカーソルで送ります。最後のページはnext_cursor: nullです。

クエリパラメータ

member_idstring条件付き

会員ID。buyer_cellphoneとどちらか一方が必須 — 両方ない場合は400

buyer_cellphonestring条件付き

注文者の携帯電話番号（数字のみ）。member_idと一緒に来た場合は、両方に一致する注文のみ返してください

order_idstring任意

この注文のみ照会

order_statusstring任意

Cafe24ステータスコードのカンマ区切り（例：N30,N40）

start_date / end_datestring任意

注文日の範囲（YYYY-MM-DDまたはISO 8601）

embedstring任意

Lilloはitems,receivers,buyer,shipmentsを送ります

cursorstring任意

前回レスポンスのmeta.next_cursor（Cafe24のoffsetの代わり）

limitnumber任意

デフォルト10、最大50。50を超えた場合は50に制限してください

パラメータタイプ必須説明

member_idstring条件付き会員ID。buyer_cellphoneとどちらか一方が必須 — 両方ない場合は400

buyer_cellphonestring条件付き注文者の携帯電話番号（数字のみ）。member_idと一緒に来た場合は、両方に一致する注文のみ返してください

order_idstring任意この注文のみ照会

order_statusstring任意Cafe24ステータスコードのカンマ区切り（例：N30,N40）

start_date / end_datestring任意注文日の範囲（YYYY-MM-DDまたはISO 8601）

embedstring任意Lilloはitems,receivers,buyer,shipmentsを送ります

cursorstring任意前回レスポンスのmeta.next_cursor（Cafe24のoffsetの代わり）

limitnumber任意デフォルト10、最大50。50を超えた場合は50に制限してください

リクエスト

curl "https://api.mall.example.com/v1/orders?member_id=m_1001&limit=10&embed=items,receivers,buyer,shipments" \
  -H "Authorization: Bearer $LILLO_API_KEY" \
  -H "X-Lillo-Api-Version: 2026-11-01"

レスポンス — 200 OK

{
  "data": [
    {
      "order_id": "20261110-0001234",
      "order_date": "2026-11-10T21:14:03+09:00",
      "payment_date": "2026-11-10T21:15:10+09:00",
      "member_id": "m_1001",
      "paid": "T",
      "payment_method": ["card"],
      "currency": "KRW",
      "payment_amount": "45000",
      "actual_order_amount": { "shipping_fee": "3000" },
      "receivers": [
        { "name": "K*** S.", "cellphone": "010-****-5821",
          "zipcode": "06236", "address1": "123 Teheran-ro", "address2": "4F" }
      ],
      "items": [
        {
          "order_item_code": "20261110-0001234-01",
          "product_no": "77",
          "product_name": "Wool Crew Knit",
          "option_value": "Color=Ivory, Size=M",
          "quantity": 1,
          "product_price": "42000",
          "option_price": "0",
          "order_status": "N30",
          "shipped_date": "2026-11-11T10:02:00+09:00",
          "image": "https://cdn.mall.example.com/products/77/main.jpg"
        }
      ],
      "shipments": [
        { "shipping_code": "D-20261111-0001", "shipping_company_code": "0006",
          "shipping_company_name": "CJ Logistics", "tracking_no": "684122140001",
          "status": "shipping",
          "items": [{ "order_item_code": "20261110-0001234-01" }] }
      ],
      "order_url": "https://mall.example.com/myshop/order/detail.html?order_id=20261110-0001234",
      "customs": null
    }
  ],
  "meta": { "next_cursor": "eyJpZCI6MTIzNH0" }
}

レスポンスフィールドは注文オブジェクトのページにまとめています。

注文詳細

GET/v1/orders/{order_id}

order_idstring必須

注文番号（パス）

member_idstring条件付き

所有者 — buyer_cellphoneとどちらか一方が必須

buyer_cellphonestring条件付き

所有者 — 数字のみ

パラメータタイプ必須説明

order_idstring必須注文番号（パス）

member_idstring条件付き所有者 — buyer_cellphoneとどちらか一方が必須

buyer_cellphonestring条件付き所有者 — 数字のみ

レスポンスは{ "data": Order }で、形式は注文一覧と同じです。注文が存在しない場合も、その所有者の注文でない場合も、同じく404を返してください。他人の注文が存在すること自体が分からないようにするためです。

リクエスト

curl "https://api.mall.example.com/v1/orders/20261110-0001234?buyer_cellphone=01012345821" \
  -H "Authorization: Bearer $LILLO_API_KEY" \
  -H "X-Lillo-Api-Version: 2026-11-01"

配送照会（任意）

GET/v1/orders/{order_id}/shipments

所有者パラメータが必須で、レスポンスは{ "data": [Shipment] }です。注文のレスポンスにshipmentsを含めれば、このエンドポイントは不要です。capabilitiesのshipments_endpointで知らせてください。

エラー

HTTP	code	発生条件
400	`invalid_request`	所有者（`member_id`・`buyer_cellphone`）の指定がない
401	`unauthorized`	APIキーがない、または誤っている
404	`not_found`	注文が存在しない、またはその所有者の注文ではない
429	`rate_limited`	レート制限を超えた

エラーレスポンス

HTTP/1.1 400
{ "error": { "code": "invalid_request", "message": "member_id or buyer_cellphone is required" } }

HTTP/1.1 404
{ "error": { "code": "not_found", "message": "Order not found" } }

前へ対応機能の宣言次へ注文オブジェクト