リクナビ進学に掲載されている学校情報を検索できるWebサービスです。このリファレンスはversion2のもので、2007/08/01公開済みのversion1とは異なります。version2では学校を軸とした検索がしやすい仕様となっております。

• 学校検索API
• キャンパス検索API
• 学問分類マスタAPI
• 学問マスタAPI
• 仕事大分類マスタAPI
• 仕事分類マスタAPI
• 仕事マスタAPI
• 資格大分類マスタAPI
• 資格分類マスタAPI
• 資格マスタAPI
• 地域マスタAPI
• 県マスタAPI
• 校種マスタAPI
• エラー時のレスポンス
• Flashからの利用方法

学校検索API

リクエストURL

• http://webservice.recruit.co.jp/shingaku/school/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
code	学校コード	学校に割り当てられた番号で検索します。*2	*1	(例)SC999999
area	地域コード	地域マスタAPI参照　複数指定可能*2	*1	(例)13
pref	県コード	県マスタAPI参照　複数指定可能*2　エイリアスとしてpref_cdも可	*1	(例)13
category	校種コード	校種マスタAPI参照　複数指定可能*2 エイリアスとしてcategory_cdも可	*1	(例)11
keyword	フリーワード	学校名、県名、学校名かな、学部、学科、キャンパス名、住所、説明のフリーワード検索が可能です。(utf-8、urlエンコーディング) 複数指定可能*2	*1	(例)東京,広告
subject	学問コード	学問マスタAPI参照 複数指定可能*2 エイリアスとしてsubject_cdも可	*1	(例)a1010
work	仕事コード	仕事マスタAPI参照　複数指定可能*2　エイリアスとしてwork_cdも可	*1	(例)a2010
license	資格コード	資格マスタAPI参照　複数指定可能*2	*1	(例)a2010
datum	測地系	キャンパスの緯度・経度の測地系を指定できます。world (世界測地系)、tokyo (日本測地系)		初期値はworld
order	ソート順	検索結果の並び順を指定します。		0:リクナビ進学おすすめ順(初期値) 1:0と同じ 2:県順 3:学校名五十音順
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		初期値：10、最小1、最大100
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xml または json または jsonp。

• *1：いずれか最低1つが必要
• *2：複数可のパラメータの指定方法
  name=value1&name=value2&...または name=value1,value2,...

サンプルクエリ

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

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.01
results_available	クエリー条件にマッチする、検索結果の全件数	251
results_returned	このＸＭＬに含まれる検索結果の件数	10
results_start	検索結果の開始位置	1
school	学校 [複数要素]
code	学校コード	SC999999
name	学校名	リクルート大学
kana	学校名カナ	リクルートダイガク
title	タイトル	生き生きとした人材を育成
desc	概要	将来を見据えて、国際社会で通用する、生き生きとした人材を育成することを目指しています
fee	初年度納入金	＜2009年度納入金＞134万6700円（初年度納入金）
photo	学校のメイン写真のURL
l	大
s	小
feature	特長 [複数要素]
title	タイトル	学ぶ内容・カリキュラムが魅力
desc	概要	地球温暖化の現場を検証するために、３ヶ月間の氷河を観察する。
photo	特長写真のURL
urls	特長ページへのURL
mobile	携帯URL
pc	URL
qr	QRコード
campus	キャンパス [複数要素]
code	キャンパスコード　学部、学科、コースで指定されている、キャンパスコードに対応	001
name	キャンパス名	本部所在地
address	住所	〒105-0021東京都港区東新橋1-2-5
datum	測地系	tokyo
latitude	緯度	35.049349
longitude	経度	137.05293
access	アクセス [複数要素]	「本庁」駅からバス　大学前停下車　1分
category	校種
code	校種コード	0011
name	校種名	国立大学
org	学部／学科／コース [複数要素] 第一階層が学部とは限りません。
name	名称	工芸学部
desc	概要	理想の経済社会を目指しより良い制度や政策を提案できる力を身につける。
number	募集人数	180
campus	キャンパスコード [複数要素]	001
urls	学部のページへのURL
mobile	携帯URL
pc	URL
qr	QRコード
org	子要素 [複数要素] 再帰的な構造になります。学部直下に（学科を挟まずに)コースが存在する場合もあります。
pref	県 [複数要素]
code	県コード	13
name	県名	東京
area	地域
code	地域コード	03
name	地域名	関東
urls	学校トップページのURL
mobile	携帯URL
pc	URL
qr	QRコード
koukishin_urls	「好奇心の授業」ページへのURL
mobile	携帯URL
pc	URL
qr	QRコード
senpai_urls	「先輩の仕事」ページのURL
mobile	携帯URL
pc	URL
qr	QRコード
pamphlet	資料請求：パンフレット
free	無料版パンフレット 1:あり 0:なし
pay	有料版のパンフレット 1:あり 0:なし
urls	パンフレット資料請求のURL
mobile	携帯URL
pc	URL
qr	QRコード
application	資料請求：願書
free	無料版願書 1:あり 0:なし
pay	有料版願書 1:あり 0:なし
urls	願書資料請求のURL
mobile	携帯URL
pc	URL
qr	QRコード

キャンパス検索API

リクエストURL

• http://webservice.recruit.co.jp/shingaku/campus/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
code	キャンパスコード	複数指定可能*2	*1	(例)1234567
school	学校コード	学校検索API参照　複数指定可能*2	*1	(例)SC000000
pref	県コード	県マスタAPI参照　複数指定可能*2　エイリアスとしてpref_cdも可	*1	(例)13
category	校種コード	校種マスタAPI参照　複数指定可能*2 エイリアスとしてcategory_cdも可	*1	(例)11
zip	郵便番号	前方一致、ハイフンなしで指定	*1	23100
keyword	フリーワード	住所、学校名、学部名、学科名、コース名を対象にフリーワード検索が可能です。(UTF-8、URLエンコーディング) 複数指定可能*2		(例)東京,文学
lat	緯度	ある地点からの範囲内の学校の検索を行う場合の緯度です。	*1	(例)35.669220
lng	経度	ある地点からの範囲内の学校の検索を行う場合の経度です。	*1	(例)139.761457
range	検索範囲	ある地点からの範囲内の学校の検索を行う場合の検索範囲です。		1:500m 2:1000m 3:5km(初期値) 4:10km 5:50km
datum	測地系	緯度・経度の測地系を指定できます。world (世界測地系)、tokyo (日本測地系)		初期値はworld
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

• *1：いずれか最低1つが必要
• *2：複数可のパラメータの指定方法
  name=value1&name=value2&...または name=value1,value2,...
• *3：ソート順は、緯度経度を指定した場合は、距離順。それ以外のときは郵便番号順になります

サンプルクエリ

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

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	9
results_returned	このＸＭＬに含まれる検索結果の件数	12
results_start	検索結果の開始位置	1
campus	キャンパス [複数要素]
code	キャンパスコード	ad010
name	キャンパス名	本部所在地
zip	郵便番号	1050021
access	アクセス [複数要素]	「本庁」駅からバス　大学前停下車　1分
address	住所	〒105-0021東京都港区東新橋1-2-5
campus_hosoku	問合せ先・所在地_補足説明
datum	測地系	tokyo
latitude	緯度	35.049349
longitude	経度	137.05293
school
code	学校コード	SC999999
name	学校名	リクルート大学
category	校種
code	校種コード	0011
name	校種名	国立大学
org	学部／学科／コース [複数要素] 第一階層が学部とは限りません。
name	名称	工芸学部
desc	概要	理想の経済社会を目指しより良い制度や政策を提案できる力を身につける。
number	募集人数	180
campus	キャンパスコード [複数要素]	001
urls	学部のページへのURL
mobile	携帯URL
pc	URL
qr	QRコード
org	子要素 [複数要素] 再帰的な構造になります。学部直下に（学科を挟まずに)コースが存在する場合もあります。
pref	県 [複数要素]
code	県コード	13
name	県名	東京
area	地域
code	地域コード	03
name	地域名	関東
urls	学校トップページのURL
mobile	携帯URL
pc	URL
qr	QRコード

学問分類マスタAPI

リクエストURL

• http://webservice.recruit.co.jp/shingaku/subject_grp/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

サンプルクエリ

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

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	9
results_returned	このＸＭＬに含まれる検索結果の件数	12
results_start	検索結果の開始位置	1
subject_grp	学問分類 [複数要素]
code	学問分類コード	ad010
name	学問分類名	文化・地理・歴史

学問マスタAPI

リクエストURL

• http://webservice.recruit.co.jp/shingaku/subject/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
code	学問コード	学問コード　複数指定可能*1		(例)a1010
subject_grp	学問分類コード	学問分類マスタAPI参照 複数指定可能*1		(例)ad010
work	仕事コード	仕事マスタAPI参照　複数指定可能*1		(例)a1300
license	資格コード	資格マスタAPI参照 複数指定可能*1		(例)v0180
keyword	フリーワード	学問名、概要に関してフリーワード検索が可能です。(UTF-8、URLエンコーディング) 複数指定可能*1		(例)東京,広告
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		初期値：10、最小1、最大100
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xml または json または jsonp。

• *1：複数可のパラメータの指定方法
  name=value1&name=value2&...または name=value1,value2,...

サンプルクエリ

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

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.01
results_available	クエリー条件にマッチする、検索結果の全件数	251
results_returned	このＸＭＬに含まれる検索結果の件数	10
results_start	検索結果の開始位置	1
subject	学問 [複数要素]
code	学問コード	a1050
name	学問名	日本文化学
desc	概要	日本独自の文化について研究する
subject_grp	学問分類
code	学問分類コード	ad010
name	学問分類名	文化・地理・歴史
urls
pc	URL	http://shingakunet.com...
mobile	携帯URL	http://shingakunet.com...
qr	QRコード	http://webservice...

仕事大分類マスタAPI

リクエストURL

• http://webservice.recruit.co.jp/shingaku/work_lgrp/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

サンプルクエリ

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

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	9
results_returned	このＸＭＬに含まれる検索結果の件数	9
results_start	検索結果の開始位置	1
work_lgrp	仕事大分類 [複数要素]
code	仕事大分類コード	ac110
name	仕事大分類名	公務員・法律・政治
desc	概要	公務員・法律・政治の分野

仕事分類マスタAPI

リクエストURL

• http://webservice.recruit.co.jp/shingaku/work_grp/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
code	仕事分類コード	複数指定可能*1		(例)ac110
work_lgrp	仕事大分類コード	仕事大分類マスタAPI参照 複数指定可能*1		(例)ad010
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

サンプルクエリ

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

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	9
results_returned	このＸＭＬに含まれる検索結果の件数	12
results_start	検索結果の開始位置	1
work_grp	仕事分類 [複数要素]
code	仕事分類コード	ac110
name	仕事分類名	公務員・政治
desc	概要	公務員・政治に関わる仕事
work_lgrp	仕事大分類
code	仕事大分類コード	ac110
name	仕事大分類名	公務員・法律・政治
desc	概要	公務員・法律・政治の分野

仕事マスタAPI

リクエストURL

• http://webservice.recruit.co.jp/shingaku/work/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
code	仕事コード	仕事コード　複数指定可能*1		(例)a1300
work_grp	仕事分類コード	仕事分類マスタAPI参照 複数指定可能*1		(例)ac110
subject	学問コード	学問マスタAPI参照　複数指定可能*1		(例)a1010
license	資格コード	資格マスタAPI参照　複数指定可能*1		(例)v0180
keyword	フリーワード	仕事名、概要に関してフリーワード検索が可能です。(UTF-8、URLエンコーディング) 複数指定可能*1		(例)東京,広告
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		初期値：10、最小1、最大100
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xml または json または jsonp。

• *1：複数可のパラメータの指定方法
  name=value1&name=value2&...または name=value1,value2,...

サンプルクエリ

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

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.01
results_available	クエリー条件にマッチする、検索結果の全件数	251
results_returned	このＸＭＬに含まれる検索結果の件数	10
results_start	検索結果の開始位置	1
work	仕事 [複数要素] 注意:同一の仕事コードが、複数の仕事分類に属する場合があります。よって、レスポンスには同一仕事コードのレスポンスが複数含まれることがあります。
code	仕事コード	a1300
name	仕事名	国際公務員
desc	概要	国連などの国際機関で世界のために働く職員
work_grp	仕事分類
code	仕事分類コード	ac110
name	仕事分類名	公務員・政治
desc	概要	公務員・政治に関わる仕事
work_lgrp	仕事大分類
code	仕事大分類コード	ac110
name	仕事大分類名	公務員・法律・政治
desc	概要	公務員・法律・政治の分野
urls
pc	URL	http://shingakunet.com...
mobile	携帯URL	http://shingakunet.com...
qr	QRコード	http://webservice...

資格大分類マスタAPI

リクエストURL

• http://webservice.recruit.co.jp/shingaku/license_lgrp/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

サンプルクエリ

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

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	9
results_returned	このＸＭＬに含まれる検索結果の件数	12
results_start	検索結果の開始位置	1
license_lgrp	資格大分類 [複数要素]
code	資格大分類コード	ad010
name	資格大分類名	法律・政治
desc	概要	法律・政治の分野

資格分類マスタAPI

リクエストURL

• http://webservice.recruit.co.jp/shingaku/license_grp/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
code	資格分類コード	複数指定可能*1		(例)ac111
license_lgrp	資格大分類コード	資格大分類マスタAPI参照 複数指定可能*1		(例)ad010
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

サンプルクエリ

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

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	9
results_returned	このＸＭＬに含まれる検索結果の件数	9
results_start	検索結果の開始位置	1
license_grp	資格分類 [複数要素]
code	資格分類コード	ac111
name	資格分類名	政治
desc	概要	政治に関わる資格
license_lgrp	資格大分類
code	資格大分類コード	ad010
name	資格分類名	法律・政治
desc	概要	法律・政治の分野

資格マスタAPI

リクエストURL

• http://webservice.recruit.co.jp/shingaku/license/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
code	資格コード	資格コード 複数指定可能*1		(例)v0180
license_grp	資格分類コード	資格分類マスタAPI参照 複数指定可能*1		(例)ac111
license_lgrp	資格大分類コード	資格大分類マスタAPI参照 複数指定可能*1		(例)ad010
work	仕事コード	仕事マスタAPI参照 複数指定可能*1		(例)a1300
subject	学問コード	学問マスタAPI参照　複数指定可能*1		(例)a1010
keyword	フリーワード	資格名、概要に関してフリーワード検索が可能です。(UTF-8、URLエンコーディング) 複数指定可能*1		(例)東京,広告
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		初期値：10、最小1、最大100
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xml または json または jsonp。

• *1：複数可のパラメータの指定方法
  name=value1&name=value2&...または name=value1,value2,...

サンプルクエリ

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

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.01
results_available	クエリー条件にマッチする、検索結果の全件数	251
results_returned	このＸＭＬに含まれる検索結果の件数	10
results_start	検索結果の開始位置	1
license	資格 [複数要素] 注意:同一の資格コードが、複数の資格分類に属する場合があります。よって、レスポンスには同一資格コードのレスポンスが複数含まれることがあります。
code	資格コード	v0120
name	資格名	国会議員政策担当秘書資格試験＜国＞
desc	概要	国会議員政策担当秘書への道がひらける資格。政策スタッフとして議員をサポートする
license_lgrp	資格大分類
code	資格大分類コード	ad010
name	資格分類名	法律・政治
desc	概要	法律・政治の分野
license_grp	資格分類
code	資格分類コード	ac111
name	資格分類名	政治
desc	概要	政治に関わる資格
urls
pc	URL	http://shingakunet.com...
mobile	携帯URL	http://shingakunet.com...
qr	QRコード	http://webservice...

地域マスタAPI

リクエストURL

• http://webservice.recruit.co.jp/shingaku/area/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

サンプルクエリ

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

レスポンスフィールド

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

県マスタAPI

リクエストURL

• http://webservice.recruit.co.jp/shingaku/pref/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
code	県コード	県コード 複数指定可能*1		(例)13
area	地域コード	地域コード 複数指定可能*1		(例)03
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

• *1：複数可のパラメータの指定方法
  name=value1&name=value2&...または name=value1,value2,...
• *2：v1のエリアマスタと互換性があります。レスポンスに地域が追加されました。

サンプルクエリ

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

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	47
results_returned	このＸＭＬに含まれる検索結果の件数	47
results_start	検索結果の開始位置	1
pref	県 [複数要素]
code	県コード	13
name	県名	東京
area	地域
code	地域コード	03
name	地域名	関東

校種マスタAPI

リクエストURL

• http://webservice.recruit.co.jp/shingaku/category/v2/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

サンプルクエリ

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

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
category	校種 [複数要素]
code	校種コード	0011
name	校種テキスト	国立大学

エラー時のレスポンス

<?xml version="1.0" encoding="UTF-8"?>
<results xmlns="http://webservice.recruit.co.jp/shingaku/">
  <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/shingaku/crossdomain.xml");

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