カテゴリ検索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キーapikeyString○-各ユーザごとのAPIキー
親カテゴリIDcategoryIdinteger○0rootカテゴリIDは「0」
コールバック関数callbackString  JSONP形式の場合のみ使用する、コールバック関数。

出力パラメータ

カテゴリ検索API使用時の結果一覧です。

項目名フィールド名型備考
共通ヘッダ
APIバージョンAPIVersionStringAPIのバージョンを表します
該当件数Countinteger検索結果の該当件数を表します
状態StatusStringAPIの問合せ結果をメッセージで返します。
サービス固有パラメータ
親カテゴリ情報Parent入力したカテゴリIDの親カテゴリを表します。
 カテゴリ階層Levelintegerカテゴリの階層を表します。（値は0~3の整数値）
 カテゴリIDIdintegerカテゴリIDを表します
 カテゴリ名称NameStringカテゴリ名称を表します
 カテゴリURLUrlStringカテゴリを表すURL
自カテゴリ情報Current入力されたカテゴリIDの情報を表します。
 カテゴリ階層Levelintegerカテゴリの階層を表します。（値は0~3の整数値）
 カテゴリIDIdintegerカテゴリIDを表します
 カテゴリ名称NameStringカテゴリ名称を表します
 カテゴリURLUrlStringカテゴリを表すURL
子カテゴリ情報Category入力されたカテゴリIDの子カテゴリを表します。
 カテゴリ階層Levelintegerカテゴリの階層を表します。（値は1~3の整数値）
 カテゴリIDIdintegerカテゴリIDを表します
 カテゴリ名称NameStringカテゴリ名称を表します
 カテゴリURLUrlStringカテゴリを表す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>