カテゴリ検索API
カテゴリ検索APIとは、coneco.netでのカテゴリの情報、階層を取得するAPIです。
カテゴリはconeco.netでの、以下のページに相当し、深さ(Level)1～3まで存在します。
- 大カテゴリ(Level1)
- パソコン･周辺機器等の、各タブことのページ
- 中カテゴリ(Level2)
- デスクトップパソコン等のページ
- 小カテゴリ(Level3)
- デスクトップパソコン(Windows)等の詳細ページ
リクエストURL
- XML形式
- http://api.coneco.net/cws/v1/SearchCategories?apikey=***&categoryId=0
- JSON or JSONP形式
- http://api.coneco.net/cws/v1/SearchCategories_json?apikey=***&categoryId=0&callback=method
入力パラメータ
カテゴリ検索APIでの指定可能なパラメータの一覧です。
| 項目名 | フィールド名 | 型 | 必須 | デフォルト | 備考 |
|---|---|---|---|---|---|
| APIキー | apikey | String | ○ | - | 各ユーザごとのAPIキー |
| 親カテゴリID | categoryId | integer | ○ | 0 | rootカテゴリIDは「0」 |
| コールバック関数 | callback | String | JSONP形式の場合のみ使用する、コールバック関数。 |
出力パラメータ
カテゴリ検索API使用時の結果一覧です。
| 項目名 | フィールド名 | 型 | 備考 | |
|---|---|---|---|---|
| 共通ヘッダ | ||||
| APIバージョン | APIVersion | String | APIのバージョンを表します | |
| 該当件数 | Count | integer | 検索結果の該当件数を表します | |
| 状態 | Status | String | APIの問合せ結果をメッセージで返します。 | |
| サービス固有パラメータ | ||||
| 親カテゴリ情報 | Parent | 入力したカテゴリIDの親カテゴリを表します。 | ||
| カテゴリ階層 | Level | integer | カテゴリの階層を表します。（値は0~3の整数値） | |
| カテゴリID | Id | integer | カテゴリIDを表します | |
| カテゴリ名称 | Name | String | カテゴリ名称を表します | |
| カテゴリURL | Url | String | カテゴリを表すURL | |
| 自カテゴリ情報 | Current | 入力されたカテゴリIDの情報を表します。 | ||
| カテゴリ階層 | Level | integer | カテゴリの階層を表します。（値は0~3の整数値） | |
| カテゴリID | Id | integer | カテゴリIDを表します | |
| カテゴリ名称 | Name | String | カテゴリ名称を表します | |
| カテゴリURL | Url | String | カテゴリを表すURL | |
| 子カテゴリ情報 | Category | 入力されたカテゴリIDの子カテゴリを表します。 | ||
| カテゴリ階層 | Level | integer | カテゴリの階層を表します。（値は1~3の整数値） | |
| カテゴリID | Id | integer | カテゴリIDを表します | |
| カテゴリ名称 | Name | String | カテゴリ名称を表します | |
| カテゴリURL | Url | String | カテゴリを表すURL | |
サンプル出力
検索条件：カテゴリID「1」（Level=1、「パソコン･周辺機器」）に属する、カテゴリID一覧を取得する。
http://api.coneco.net/cws/v1/SearchCategories?apikey=******&categoryId=1
<?xml version="1.0" encoding="UTF-8"?>
<Categories xmlns="http://api.coneco.net/cws/v1/">
<Header>
<APIVersion>1.4.0</APIVersion>
<Count>17</Count>
<Status>Success</Status>
</Header>
<Parent>
<Level>0</Level>
<Id>0</Id>
<Name>root</Name>
<Url>http://www.coneco.net/</Url>
</Parent>
<Current>
<Level>1</Level>
<Id>1</Id>
<Name>パソコン・周辺機器</Name>
<Url>http://www.coneco.net/top_pchard.html</Url>
</Current>
<Category>
<Level>2</Level>
<Id>10110</Id>
<Name>デスクトップパソコン</Name>
<Url>http://www.coneco.net/mid/10110.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>10120</Id>
<Name>ノートパソコン</Name>
<Url>http://www.coneco.net/mid/10120.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>10130</Id>
<Name>ショップブランド・タブレットPC・サーバ</Name>
<Url>http://www.coneco.net/mid/10130.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>10210</Id>
<Name>PDA・モバイル</Name>
<Url>http://www.coneco.net/mid/10210.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>11010</Id>
<Name>モニター・プロジェクター</Name>
<Url>http://www.coneco.net/mid/11010.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>11020</Id>
<Name>プリンター・複合機・スキャナ</Name>
<Url>http://www.coneco.net/mid/11020.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>11060</Id>
<Name>入力機器</Name>
<Url>http://www.coneco.net/mid/11060.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>11099</Id>
<Name>その他周辺機器</Name>
<Url>http://www.coneco.net/mid/11099.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>12035</Id>
<Name>フラッシュメモリ</Name>
<Url>http://www.coneco.net/mid/12035.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>13010</Id>
<Name>有線ルータ・モデム・TA</Name>
<Url>http://www.coneco.net/mid/13010.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>13040</Id>
<Name>無線LAN</Name>
<Url>http://www.coneco.net/mid/13040.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>13099</Id>
<Name>その他 ネットワーク機器</Name>
<Url>http://www.coneco.net/mid/13099.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>15050</Id>
<Name>ケーブル</Name>
<Url>http://www.coneco.net/mid/15050.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>16010</Id>
<Name>ＵＰＳ（無停電電源装置）</Name>
<Url>http://www.coneco.net/mid/16010.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>17010</Id>
<Name>各種メディア</Name>
<Url>http://www.coneco.net/mid/17010.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>17020</Id>
<Name>トナー・インク・用紙</Name>
<Url>http://www.coneco.net/mid/17020.html</Url>
</Category>
<Category>
<Level>2</Level>
<Id>17025</Id>
<Name>電池・充電池・充電器</Name>
<Url>http://www.coneco.net/mid/17025.html</Url>
</Category>
</Categories>
