ポンパレモールWEBサービス/商品詳細API

説明

商品詳細APIは、ポンパレモールに公開されている商品の詳細情報を取得する機能を提供します。

リクエストURL

http://item.api.ponparemall.com/1_0_0/detail/

リクエストパラメーター

パラメーター 項目名 説明 必須
shopUrl ショップURL [ショップURL]は商品ページのURLで確認できます。
「http://store.ponparemall.com/[ショップURL]/goods/[商品管理ID]/」
itemManageId 商品管理ID [商品管理ID]は商品ページのURLで確認できます。
「http://store.ponparemall.com/[ショップURL]/goods/[商品管理ID]/」
imgSize 商品画像サイズ 64,80,96,100,144,150,160,192,200,240,300,480,500
(デフォルト:150)
-
requestKey 返却項目 複数指定時は、カンマ区切り。何も指定されてない場合は全項目返却-
key 認証キー APIを利用するためのキーです。
アカウント登録時に割り当てられるAPIキーを指定してください。
-
format 返却形式 json / jsonp
(デフォルト:jsonp)
-
callback callback関数 jsonpとして出力する際のコールバック関数名
(デフォルト:"callback")
-

サンプルリクエストURL

※ keyの「**********」を取得したAPIキーに置き換えて実行してください。

※ [ショップURL]、[商品管理ID]は商品ページのURLの、下記の箇所が該当します。
    「http://store.ponparemall.com/[ショップURL]/goods/[商品管理ID]/」

レスポンスフィールド

     
Lv フィールド 項目名 備考 出現回数
1 itemInfo 商品情報 1
1 itemId 商品ID 1
1 shopId 店舗ID 1
2     genreId ジャンルID 1
2     itemName 商品名 1
2     janCode JANコード 1
2     saleKind 販売種別 1:通常 / 2:プレゼント / 3:共同購入 / 4:予約購入 / 5:定期購入 / 6:オークション / 7:頒布会1
2     itemManageId 商品管理ID 1
2     itemIdDisp 商品ID(表示用) 1
2     noshiFlg のしフラグ 0:のし対応しない / 1:のし対応する1
2     saleStartTs 販売開始日時 yyyy/mm/dd HH:MM:SS1
2     saleEndTs 販売終了日時 yyyy/mm/dd HH:MM:SS1
2     salePrice 販売価格 1
2     salePriceIncTax 販売価格(税込) 1
2     pointRate ポイント率 1
2     pointCount ポイント数 1
2     pointBonusStartTs ポイント変倍開始時間 yyyy/mm/dd HH:MM:SS1
2     pointBonusEndTs ポイント変倍終了時間 yyyy/mm/dd HH:MM:SS1
2     saleSts 販売ステータス 1:未販売 / 2:販売中1
2     incShippingFlg 送料込フラグ 0:送料別 / 1:送料無料1
2     taxKind 消費税種別 1:消費税別 / 2:消費税込 / 3:非課税1
2     dispPrice 表示価格 1
2     codAvailableFlg 代金引換可フラグ 0:利用不可 / 1:利用可能1
2     openPriceFlg オープン価格フラグ 0 / 1:オープン価格1
2     orderAcceptedCntKind 注文受付数種別 1:自由入力 / 2:非表示 / 3:最大購入数1
2     maxPrchsCnt 最大購入数 1
2     sepaShippingFee 個別送料 1
2     itemDescription1 商品説明(1) 1
2     itemDescription2 商品説明(2) 1
2     itemDescrptionText 商品説明(テキストのみ) 1
2     itemDescrptionSp 商品説明(スマートフォン用) 1
2     medicineDescrption 医薬品説明文 1
2     catchCopy キャッチコピー 1
2     orderEnableFlg 注文ボタンフラグ 0:ボタンをつけない / 1:ボタンをつける1
2     inquiryEnableFlg 問い合わせボタンフラグ 0:問合せリンクをつけない / 1:問合せリンクをつける1
2     invDispKind 在庫表示種別 1:表示 / 2:非表示1
2     invKind 在庫種別 1:通常在庫 / 2:SKU在庫 / 3:設定なし1
2     itemImgInfoList 商品画像 1
3         itemImgUrl 商品画像URL N
3         sortOrder ソート順 N
2     salesPriceName 通常販売時の販売価格項目名 1
2     dualPriceName 二重価格設定時の二重価格項目名 1
2     dualSalesPriceName 二重価格設定時の販売価格項目名 1
2     openPriceName オープン価格表示時のオープン価格項目名 1
2     openSalesPriceName オープン価格表示時の販売価格項目名 1
2     shopName ショップ名 1
2     shopTopUrl ショップトップURL 1
2     shopUrl ショップURL 1
2     itemUrl 商品URL 1
2     giftAvailableFlg ギフト対応可フラグ 0:ギフトチェックボックを表示しない / 1:ギフトチェックボックスを表示する1
2     invCnt 在庫数 通常在庫数の場合:在庫数
SKU在庫の場合:SKU在庫の総数
在庫設定なしの場合:null
1
2     partialStockoutFlg 一部在庫切れフラグ 通常在庫数の場合:在庫数が0の場合は1
SKU在庫の場合:在庫数0のSKU在庫が1つでも存在する場合は1
在庫設定なしの場合:0
1
2     itemOptGrpInfoList 購入オプション情報リスト 1
4             itemOptGrpId 購入オプショングループID N
4             optGrpName 購入オプション名 N
4             itemOptSubInfoList 購入オプション選択肢 N
5                 itemOptSubNo 購入オプション選択肢枝番 N
5                 itemOptName 購入オプション選択肢名 N
2     skuInfoList SKU情報リスト 1
3         skuInfo SKU情報 1
4             skuItemVaxisName SKU縦軸名 N
4             skuItemHaxisName SKU横軸名 N
4             skuInvDispKind SKU在庫表示区分 1:表示 / 2:マーク表示 / 3:非表示 /4:設定なしN
4             skuMarkDispBorder SKUマーク表示閾値 SKU在庫表示区分が2:マーク表示の場合のみ設定
在庫数がこの値以下の場合、「△」印を表示する。
N
4             itemSkuInvAxisInfoList SKU在庫軸情報 N
5                 skuItemId SKU項目ID N
5                 invAxisName 在庫軸名 N
5                 mtrxAxisKind 縦横種別 1:横 / 2:縦N
5                 skuInvAxisNo 商品SKU在庫軸番号 N
4             itemSkuInvInfoList SKU在庫情報 N
5                 itemSkuInvId 商品SKU在庫ID N
5                 vaxisId 縦軸ID N
5                 haxisId 横軸ID N
5                 skuInvCnt SKU在庫数 N
2     shopCtgryInfoList 店舗カテゴリー情報 1
3         shopCtgryId 店舗カテゴリーID 1
3         shopCtgryUrl 店舗カテゴリーURL 1
3         shopCtgryName 店舗カテゴリー名 1
2     shopReviewCount 店舗レビュー数 1
2     shopReviewScore 店舗レビュースコア 1
2     shopReviewUrl 店舗レビューURL 1
2     itemReviewCount 商品レビュー件数 1
2     itemReviewScore 商品レビュー評点 1
2     itemReviewUrl 商品レビューURL 1
2     cardPymntAvailableFlg カード利用可能フラグ 0:利用不可 / 1:利用可能1
2     deferredPymntAvailableFlg 後払い利用可能フラグ 0:利用不可 / 1:利用可能1
2     carrierPymntAvailableFlg キャリア決済フラグ 0:利用不可 / 1:利用可能1
2     prchsStepDispFlg 配送日指定利用可能フラグ 0:利用不可 / 1:利用可能1
2     nxdayDlvAvailableFlg 翌日配送利用可能フラグ 0:利用不可 / 1:利用可能1
2     nxdayDlvUseCondition 翌日配送利用条件 1
2     nxdayDlvAreaList 翌日配送対応可能エリア 1
3         regionName 地域名 N
3         prefNames 都道府県名 N

エラー

ポンパレモールWEBサービスは共通のエラーを返します。
詳しくは、ガイドラインをご覧ください。