Lillo
開発者ドキュメントユーザーガイド
カスタムストアAPI / 商品・カタログの照会

カスタムストアAPI  /  商品・カタログ

商品・カタログの照会

商品に関する問い合わせへの回答に使います。検索・詳細はv1.0の任意機能、カタログ全件一覧とカテゴリはv1.1の任意機能です。

商品検索

GET/v1/products?product_name={keyword}&limit={n}

product_namestring必須

商品名の部分一致

limitnumber任意

最大50

レスポンス — 200 OK
{
  "data": [
    {
      "product_no": "77",
      "product_name": "Wool Crew Knit",
      "currency": "KRW",
      "price": "42000",
      "retail_price": "52000",
      "display": "T",
      "selling": "T",
      "sold_out": "F",
      "summary_description": "70% wool crew neck",
      "list_image": "https://cdn.mall.example.com/products/77/main.jpg",
      "product_url": "https://mall.example.com/product/77"
    }
  ]
}

商品詳細

GET/v1/products/{product_no}

Lilloはembed=variantsを付けて呼び出します。オプションごとの在庫（variants）があれば「Mサイズはありますか？」のような質問に正確に答えられます。在庫レベルはLilloがquantityから計算します（5個以下で残りわずか）。

product_nostring必須

商品番号

product_namestring必須

商品名

price / retail_pricestring任意

販売価格 / 定価

display / selling / sold_outstring任意

陳列・販売・品切れの有無"T"/"F"

summary_descriptionstring任意

短い説明

descriptionstring任意

詳細説明。HTMLのままで構いません — Lilloがタグを除去します

list_imagestring任意

代表画像の絶対https URL

detail_image / additional_imagesstring任意

詳細・追加画像

product_material / origin_place_value / shipping_infostring任意

素材・原産地・配送案内

variantsobject[]任意

オプションごとのvariant_code、options[]、additional_amount、selling、use_inventory、quantity

currencystring任意

拡張。通貨（省略時はKRW）

product_urlstring任意

拡張。商品ページURL

レスポンス — 200 OK
{
  "data": {
    "product_no": "77",
    "product_name": "Wool Crew Knit",
    "currency": "KRW",
    "price": "42000",
    "retail_price": "52000",
    "selling": "T",
    "sold_out": "F",
    "description": "<p>HTML is fine — Lillo strips the tags</p>",
    "list_image": "https://cdn.mall.example.com/products/77/main.jpg",
    "detail_image": "https://cdn.mall.example.com/products/77/detail.jpg",
    "product_material": "70% wool",
    "origin_place_value": "Korea",
    "shipping_info": "Ships same day for orders before 2 p.m.",
    "variants": [
      { "variant_code": "P000000X000A",
        "options": [{ "name": "Size", "value": "M" }],
        "additional_amount": "0", "selling": "T",
        "use_inventory": "T", "quantity": 3 }
    ]
  }
}

カタログ全件一覧（v1.1）

GET/v1/products?since_product_no={n}&limit=100

since_product_noがある場合は、検索ではなく全件一覧モードです。この一覧でナレッジの「商品」フォルダを同期します（capabilities catalog）。

  • product_noがsince_product_noより大きい商品を、番号の昇順でlimit（最大100）件返してください。
  • 陳列・販売の有無に関係なく、すべて返してください。非表示はLilloが処理します。最後のページはlimitより少なく返せば大丈夫です。
  • category、options、created_dateと、拡張フィールドsales_count（直近90日の販売数量、任意）を追加できます。sales_countがあれば人気順に使います。
  • Lilloは6時間ごと（KST 00:20・06:20・12:20・18:20）と、接続テストに合格した直後に呼び出します。ページ間隔は0.6秒、1回あたり最大5,000件です。
  • 価格と在庫は、回答する直前に商品詳細で再確認します。一覧は検索用のスナップショットです。
レスポンス — 一覧内の商品1件
{
  "product_no": "77",
  "product_name": "Wool Crew Knit",
  "price": "42000",
  "retail_price": "52000",
  "display": "T",
  "selling": "T",
  "sold_out": "F",
  "created_date": "2026-09-01T10:00:00+09:00",
  "list_image": "https://cdn.mall.example.com/products/77/main.jpg",
  "product_url": "https://mall.example.com/product/77",
  "category": [{ "category_no": "24", "recommend": "F", "new": "T" }],
  "options": { "options": [
    { "option_name": "Color",
      "option_value": [{ "option_text": "Ivory" }, { "option_text": "Black" }] }
  ] },
  "sales_count": 132
}

カテゴリ（v1.1）

GET/v1/categories

limitnumber任意

最大100

offsetnumber任意

スキップする件数

レスポンス — 200 OK
{
  "data": [
    { "category_no": "24", "category_name": "Knitwear",
      "parent_category_no": "1", "category_depth": 2 }
  ]
}
前へ会員照会次へ注文の書き込み
商品・カタログの照会 · 開発者ドキュメント | Lillo