 |
garittoとは
API仕様
リクエストURL
APIリクエスト送信URL
http://garitto.com/api.php?action=api_ver1_rest
&[developerId]=[value]&[type]=[value]&[parameter]=[value]…
※実際は改行しないで下さい。
[developerId]に登録ID、[type]に利用APIフラグを設定します。必須項目コードをする必要があり。
以降、｢&｣にて入力パラメーターを設定する。「keywordTag」、「keyword」,「sort0,sort1,sort2」値については、UTF-8にてURLエンコードする必要があります。
具体例
検索キーワード＝スカート
並び順＝人気順
上記の条件の場合、APIリクエストURLは以下のようになります。
APIリクエスト送信URL
http://garitto.com/api.php?action=api_ver1_rest&developerId=[DEVELOPER_ID]
&type=ProductSearch&keyword=%E3%82%B9%E3%82%AB%E3%83%BC%E3
%83%88&sort0=rankingDesc
※実際は改行しないで下さい。
パラメーターの説明
| パラメーター | 内容 |
| developerId=[DEVELOPER_ID] |
|
| type=ProductSearch |
|
| keyword=%E3%82%B9%E3%82% AB%E3%83%BC%E3%83%88 |
|
| sort0=rankingDesc |
|
入力パラメーター
| 区分 | ID | 項目 | parameter | 型 | 必須 | デフォルト | 備考 |
| 共通 | 1 | 登録ID | developerId | String | ○ | --- |
|
| 2 | 操作API | type | String | ○ | --- |
|
|
| 入力 | 1 | 検索キーワード | Keyword | String | ○ ※1 |
--- |
|
| 2 | 検索キーワード タグ |
keywordTag | String | ○ ※1 |
--- |
|
|
| 3 | カテゴリID | categoryId | int4 | ○ ※1 |
--- |
|
|
| 4 | サブカテゴリID | categorySubId | int4 | ○ ※1 |
--- |
|
|
| 6 | ソート | sort0 sort1 sort2 |
String | - | rankingDesc |
|
|
| 7 | 最小価格 | minPrice | int8 | - | 指定なし |
|
|
| 8 | 最大価格 | maxPrice | int8 | - | 指定なし |
|
|
| 9 | 1ページあたりの 取得件数 |
pageLimit | int4 | - | 30 |
|
|
| 10 | 取得ページ番号 | page | int4 | - | 1 |
|
出力パラメーター
| 区分 | ID | 分類 | 項目 | parameter | 備考 |
| 共通 出力 |
1 | - | developerId |
|
|
| - | type |
|
|||
| - | version |
|
|||
| - | keyword |
|
|||
| - | categoryId |
|
|||
| - | categorySubId |
|
|||
| - | sort |
|
|||
| - | maxPrice |
|
|||
| - | minPrice |
|
|||
| - | pageLimit |
|
|||
| - | page |
|
|||
| 2 | Status | - | Status |
|
|
| 3 | StatusMsg | - | StatusMsg |
|
|
| 出力 | 1 | 全体情報 | 検索総数 | count |
|
| 2 | ページ番号 | page |
|
||
| 3 | ページ内 商品開始番号 |
start |
|
||
| 4 | ページ内 商品終了番号 |
end |
|
||
| 5 | ページ内 検索数 |
hits |
|
||
| 7 | ページ総数 | pageCount |
|
||
| 8 | タグ情報 | productHitTagStr |
|
||
| 8 | tag |
|
|||
| 9 | cnt |
|
|||
| 10 | 商品情報 | 商品名 | productId |
|
|
| 11 | 商品名称 | productName |
|
||
| 12 | 商品説明 | productDescprition |
|
||
| 13 | 商品価格 | productPrice |
|
||
| 14 | 商品タグ | productTag |
|
||
| 15 | 商品URL | productUrl |
|
||
| 16 | 商品画像 サムネイルURL |
thImageUrl |
|
||
| 17 | ブックマーク ユーザー人数 |
productMarkUser |
|
||
| 18 | 商品レビュー数 | productReviewCnt |
|
||
| 19 | 商品あしあと数 | productFootprintCnt |
|
||
| 20 | 商品画像 通常URL |
imageUrl |
|
||
| 21 | 店舗情報 | 店ID | shopId |
|
|
| 22 | 店名 | shopName |
|
||
| 23 | 店説明 | shopDiscprition |
|
||
| 24 | 店URL | shopUrl |
|
エラー
| Statusでの表示 | 内容 |
| NotFound |
|
| UserError |
|