以下のAPIはヘアサロン検索専用です。リラク＆ビューティサロン検索用のマスタとは異なります。ご注意ください

• サロンサーチAPI
• サービスエリアマスタAPI
• 中エリアマスタAPI
• 小エリアマスタAPI
• イメージマスタAPI
• 長さマスタAPI
• こだわりマスタAPI
• こだわり設備マスタAPI
• こだわりメニューマスタAPI
• 特集マスタAPI
• 特集詳細マスタAPI
• メニュー内容マスタAPI
• ヘアカラーマスタAPI
• エラー時のレスポンス
• Flashからの利用方法

サロンサーチAPI

リクエストURL

• http://webservice.recruit.co.jp/beauty/salon/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
id	サロンID	サロンに割り当てられた番号で検索します。	*1	(例) H0123456789
name	サロン名	サロンの名前で検索(部分一致)します。	*1
name_kana	サロン名かな	サロンの読みがなで検索(部分一致)します。	*1
address	住所	サロンの住所で検索(部分一致)します。	*1
service_area	サービスエリアコード	サービスエリアに割り当てられたコード番号で検索します。指定できるコード番号はサービスエリアマスタAPIを参照。サロン名、サロン名かな、住所、キャッチのフリーワード検索(部分一致)が可能です。	*1	(例) SA
middle_area	中エリアコード	中エリアに割り当てられたコード番号で検索します。指定できるコード番号は中エリアマスタAPIを参照。サロン名、サロン名かな、住所、キャッチのフリーワード検索(部分一致)が可能です。	*1	(例) AAAA
small_area	小エリアコード	小エリアに割り当てられたコード番号で検索します。指定できるコード番号は小エリアマスタAPIを参照。サロン名、サロン名かな、住所、キャッチのフリーワード検索(部分一致)が可能です。	*1	(例) X001
feature	特集コード	特集マスタAPIのコード値で絞り込みます。 特殊記法で OR 絞り込みも可	*1	(例) SP01
feature_detail	特集詳細コード	特集詳細マスタAPIのコード値で絞り込みます。 特殊記法で OR 絞り込みも可	*1	(例) L001
keyword	フリーワード	サロン名、サロン名かな、住所、キャッチのフリーワード検索(部分一致)が可能です。	*1
lat	緯度	ある地点からの範囲内のサロンの検索を行う場合の緯度です。小数点13桁まで対応。	*1	(例) SP01
lng	経度	ある地点からの範囲内のサロンの検索を行う場合の経度です。小数点13桁まで対応。	*1	(例) SP01
range	検索範囲	ある地点からの範囲内のサロンの検索を行う場合の範囲を5段階で指定できます。		1: 300m 2: 500m 3: 1000m (初期値) 4: 2000m 5: 3000m
datum	測地系	緯度・経度の測地系を指定できます。world: 世界測地系、tokyo: 旧日本測地系。初期値は world。		(例) world
hair_image	イメージコード	スタイルのイメージに割り当てられたコード番号で検索します。指定できるコード番号は髪イメージマスタAPIを参照。複数指定する事で AND 絞り込みが可能 *2 特殊記法で OR 絞り込みも可		(例) 2
hair_length	長さコード	髪の長さで絞込むことができます。指定できるコード番号は髪長さマスタAPIを参照。複数指定する事で AND 絞り込みが可能 *2 特殊記法で OR 絞り込みも可		(例) 5
hair_ryou	髪量コード	髪量で絞り込むことができます。複数指定する事で AND 絞り込みが可能 *2 特殊記法で OR 絞り込みも可		1: 少ない 2: 普通 3: 多い
hair_shitsu	髪質コード	髪質で絞り込むことができます。複数指定する事で AND 絞り込みが可能 *2 特殊記法で OR 絞り込みも可		1: 柔かい 2: 普通 3: 硬い
hair_futosa	髪の太さコード	髪の太さで絞り込むことができます。複数指定する事で AND 絞り込みが可能 *2 特殊記法で OR 絞り込みも可		1: 細い 2: 普通 3: 太い
hair_kuse	髪のクセコード	髪のクセで絞り込むことができます。複数指定する事で AND 絞り込みが可能 *2 特殊記法で OR 絞り込みも可		1: なし 2: 少し 3: 強い
hair_kaogata	顔型コード	顔型で絞り込むことができます。複数指定する事で AND 絞り込みが可能 *2 特殊記法で OR 絞り込みも可		1: 丸型 2: 卵型 3: 四角 4: 逆三角 5: ベース
kodawari	こだわり条件コード	こだわり条件で絞り込むことができます。指定できるコード番号はこだわりマスタAPIを参照。複数指定する事で AND 絞り込みが可能 *2 特殊記法で OR 絞り込みも可		(例) 4
kodawari_setsubi	こだわり設備条件コード	設備・サービスのこだわり条件で絞り込むことができます。指定できるコード番号はこだわりマスタAPIを参照。複数指定する事で AND 絞り込みが可能 *2 特殊記法で OR 絞り込みも可		(例) 2
kodawari_menu	こだわりメニュー条件コード	メニューのこだわり条件で絞り込むことができます。指定できるコード番号はこだわりメニューマスタAPIを参照。複数指定する事で AND 絞り込みが可能 *2 特殊記法で OR 絞り込みも可		(例) 3
order	ソート順	検索結果の並び順を指定します。※位置検索の場合は指定に関係なく、強制的に距離順でソートされます。		0: ランダム(初期値) 1: サロン名かな順 2: 小エリアコード順 3: ビューティーおすすめ順
start	検索の開始位置（何件目か？）	検索結果の何件目から出力するかを指定します。		初期値: 1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		1〜100までの半角数字。初期値: 10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値: xml。

• *1：いずれか最低1つが必要
• *2：複数可のパラメータの指定方法
  name=value1&name=value2&...または name=value1,value2,...
  
• *3：OR 検索モードの指定方法
  複数の値を列挙していく中に文字列 'or' を追加する事で AND 検索では無く OR 検索に切り替わります。 (例) hair_image=1,2,3,or あるいは kodawari=3,4&kodawari=or
  hair_ryou=1,2,or,3 とした場合も出現位置は関係なく 1 2 3 すべてを一律 OR 検索します。
  OR 検索対象の値は最大10個まで指定可能です。
  

サンプルクエリ

■サロン名 "サロン" で検索 (結果は小エリアコード順)

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	251
results_returned	このＸＭＬに含まれる検索結果の件数	10
results_start	検索結果の開始位置	1
salon	[複数要素]
id	サロンID	H0123456789
last_update	最終更新日時	2007-12-31T11:11:11
name	サロン名	ホットペッパービューティサロン
name_kana	サロン名かな	ホットペッパービューティサロン
urls	URL
pc	PC用サロンURL	URL
mobile	携帯向けURL	URL
qr	QRコード画像へのURL 画像サイズ等の変更方法はこちら	URL
coupon_urls	クーポンページURL
pc	PC用クーポンページURL	URL
mobile	携帯向けURL	URL
qr	QRコード画像へのURL 画像サイズ等の変更方法はこちら	URL
address	住所	東京都中央区銀座８-４-１７
service_area	サービスエリア
code	サービスエリアコード	SA
name	サービスエリア名	関東
middle_area	中エリア
code	中エリアコード	AA
name	中エリア名	新宿・下北沢・四ツ谷
small_area	小エリア
code	小エリアコード	X001
name	小エリア名	新宿・高田馬場
open	営業時間	12:00〜24:00（最終受付24:00）
close	定休日	毎週火曜日
credit_card	クレジットカード	全て
price	カット価格	2400〜
stylist_num	スタイリスト数	３人
capacity	席数	３席
parking	駐車場	3台有
note	備考	予約優先。
kodawari	こだわり条件	４席以下の小型サロン/夜１９時以降も受付OK/一人のスタイリストが仕上げまで担当
lat	緯度（測地系は検索時に指定したもの）	35.6608183454
lng	経度（測地系は検索時に指定したもの）	139.7754267645
catch_copy	キャッチ	TV・雑誌で話題☆海外でも絶賛！
description	ディスクリプション	お勤め帰りやお買い物ついでに立ち寄れる便利な立地にあるサロン。
main	メインコンテンツ
photo	メインフォト
s	Sサイズ（119x89)	画像URL
m	Mサイズ（219x164）	画像URL
l	Lサイズ（349x262）	画像URL
caption	キャプション	贅沢な空間でリラックスできます。
mood	サロンの雰囲気[複数要素]
photo	サロンの雰囲気フォト	画像URL
caption	サロンの雰囲気キャプション	モダンデザインの外観フォルム
feature	特集詳細 [複数要素]
code	特集詳細コード	L001
name	特集詳細名	夏のイチオシスタイルがあるサロン
g_code	特集コード	L001
g_name	SP01	雰囲気から探す
photo	メインフォト
s	Sサイズ（119x89)	画像URL
m	Mサイズ（219x164）	画像URL
l	Lサイズ（349x262）	画像URL
caption	キャッチ	誰にも真似のできないあなただけのオリジナルカラー
description	ディスクリプション	カラーやパーマでは９種ものトリートメントで髪の内部から補修。

サービスエリアマスタAPI

サービスエリアのマスタを取得します。

リクエストURL

• http://webservice.recruit.co.jp/beauty/service_area/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
start	検索の開始位置（何件目か？）	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		１〜１００までの半角数字。初期値:10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値:xml。

サンプルクエリ

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	3
results_returned	このＸＭＬに含まれる検索結果の件数	3
results_start	検索結果の開始位置	1
service_area	[複数要素]
code	サービスエリアコード	SA
name	サービスエリア名	関東

中エリアマスタAPI

中エリアのマスタを取得します。

リクエストURL

• http://webservice.recruit.co.jp/beauty/middle_area/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
service_area	サービスエリア	該当するサービスエリアで絞込みます。複数選択可*1		(例) SA
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		1〜100までの半角数字。初期値: 10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値:xml。

サンプルクエリ

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
middle_area	[複数要素]
code	中エリアコード	AA
name	中エリア名	新宿・下北沢・四ツ谷
service_area
code	サービスエリアコード	SA
name	サービスエリア名	関東

小エリアマスタAPI

小エリアのマスタを取得します。

リクエストURL

• http://webservice.recruit.co.jp/beauty/small_area/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
middle_area	中エリア	該当する中エリアで絞込みます。複数選択可*1		(例) AB
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		1〜100までの半角数字。初期値:10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値:xml。

サンプルクエリ

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
small_area	[複数要素]
code	小エリアコード	X001
name	小エリア名	新宿・高田馬場
middle_area
code	中エリアコード	AA
name	中エリア名	新宿・下北沢・四ツ谷
service_area
code	サービスエリアコード	SA
name	サービスエリア名	関東

イメージマスタAPI

髪型のイメージマスタを取得します。

リクエストURL

• http://webservice.recruit.co.jp/beauty/hair_image/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		１〜１００までの半角数字。初期値:10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値:xml。

サンプルクエリ

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
hair_image	[複数要素]
code	イメージコード	1
name	イメージ名	フェミニン

長さマスタAPI

髪の長さマスタを取得します。

リクエストURL

• http://webservice.recruit.co.jp/beauty/hair_length/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		1〜100までの半角数字。初期値:10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値:xml。

サンプルクエリ

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
hair_length	[複数要素]
code	髪の長さコード	1
name	髪の長さ名	ロング

こだわりマスタAPI

こだわりマスタを取得します。

リクエストURL

• http://webservice.recruit.co.jp/beauty/kodawari/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		1〜100までの半角数字。初期値:10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値:xml。

サンプルクエリ

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
kodawari	[複数要素]
code	こだわり条件コード	1
name	こだわり条件名	１５席以上の大型サロン

こだわり設備マスタAPI

こだわり設備マスタを取得します。

リクエストURL

• http://webservice.recruit.co.jp/beauty/kodawari_setsubi/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		１〜１００までの半角数字。初期値:10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値:xml。

サンプルクエリ

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
kodawari_setsubi	[複数要素]
code	こだわり設備条件コード	1
name	こだわり設備条件名	朝１０時前でも受付OK

こだわりメニューマスタAPI

こだわりメニューマスタを取得します。

リクエストURL

• http://webservice.recruit.co.jp/beauty/kodawari_menu/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		１〜１００までの半角数字。初期値:10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値:xml。

サンプルクエリ

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
kodawari_menu	[複数要素]
code	こだわりメニュー条件コード	1
name	こだわりメニュー条件名	白髪染め（若白髪含む）
category	メニューカテゴリ [複数要素]
code	カテゴリコード	1
name	カテゴリ名	カラー

特集マスタAPI

特集マスタを取得します。

リクエストURL

• http://webservice.recruit.co.jp/beauty/feature/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
order	マスタデータのソート順	PCで表示する為のソート順 (order=1) か、モバイルで表示する為のソート順 (order=2) かを指定します。		PC用:1、モバイル用:2。初期値:1
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		１〜１００までの半角数字。初期値:10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値:xml。

サンプルクエリ

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
feature	[複数要素]
code	特集コード	SP01
name	特集名	雰囲気から探す

特集詳細マスタAPI

特集詳細マスタを取得します。特集マスタをさらに細分化したデータになります。

リクエストURL

• http://webservice.recruit.co.jp/beauty/feature_detail/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
order	マスタデータのソート順	PCで表示する為のソート順 (order=1) か、モバイルで表示する為のソート順 (order=2) かを指定します。		PC用:1、モバイル用:2。初期値:1
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		１〜１００までの半角数字。初期値:10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値:xml。

サンプルクエリ

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
feature_detail	[複数要素]
code	特集詳細コード	L002
name	特集詳細名	ちょっと贅沢なサロン
feature	特集
code	特集コード	SP02
name	特集名	雰囲気から探す

メニュー内容マスタAPI

メニュー内容マスタを取得します。

リクエストURL

• http://webservice.recruit.co.jp/beauty/menu_content/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		１〜１００までの半角数字。初期値:10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値:xml。

サンプルクエリ

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
hair_color	[複数要素]
code	メニュー内容コード	MC01
name	メニュー内容名	パーマ

ヘアカラーマスタAPI

ヘアカラーマスタを取得します。

リクエストURL

• http://webservice.recruit.co.jp/beauty/hair_color/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		１〜１００までの半角数字。初期値:10
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		xml または json または jsonp。初期値:xml。

サンプルクエリ

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
hair_color	[複数要素]
code	ヘアカラーコード	HC01
name	ヘアカラー名	ブラウン・ベージュ系

エラー時のレスポンス

<?xml version="1.0" encoding="UTF-8"?>
<results xmlns="http://webservice.recruit.co.jp/beauty/">
  <api_version>1.00</api_version>
  <error>
    <message>keyは必須パラメーターです</message>
  </error>
</results>

エラーの際でも、HTTPレスポンスステータスは常に "200 OK" が返ります。実装側では常にレスポンスXMLの内容を見てエラー判断を行ってください。

Flashからの利用方法

Flash Action Script 2.0にて本APIを利用するには1フレーム目に下記の記述を追加する必要があります:

System.security.loadPolicyFile("http://webservice.recruit.co.jp/beauty/crossdomain.xml");

このように crossdomain.xml を指定する事で、ご自身のサイト上にある Flash SWF ファイルから、本APIを利用することが可能になります。