Travel ANSWER Webサービス API リファレンス

API リファレンス

1.ツアー検索API ベータ版

リクエストフィールド
レスポンスフィールド
サンプルレスポンス
エラーレスポンス

2.方面取得API ベータ版

リクエストフィールド
レスポンスフィールド
サンプルレスポンス
エラーレスポンス

3.出発地取得API ベータ版

リクエストフィールド
レスポンスフィールド
サンプルレスポンス
エラーレスポンス

4.旅行目的取得API ベータ版

リクエストフィールド
レスポンスフィールド
サンプルレスポンス
エラーレスポンス

1.ツアー検索API ベータ版

●リクエストフィールド

フィールド名	説明	必須	初期値	備考
naigai	内外区分（国内/海外）を指定	必須	－	J：国内 W：海外
dest_code	方面コードを指定複数指定不可	必須	－	方面取得APIより取得したコードを利用する。例：国内：10:北海道海外：HWI：ハワイ
hatsu_code	出発地コードを指定複数指定不可	必須	－	出発地取得APIより取得したコードを利用する。例：国内：104：関東海外：001：東京
dep_date	出発日指定複数指定不可	任意	－	日付（yyyy/mm/dd）\| (yyyy/mm)
purpose	旅行目的複数指定可（カンマ区切り）	任意	－	旅行目的取得APIより取得したコードを利用する。例　001ハネムーン
course_type	コースタイプを指定複数指定可	任意	－	【コード一覧】 1：宿泊＋交通 2：日帰り 3：宿泊のみ 4：現地発着 ※複数指定時はカンマ区切り
keyword	キーワードを指定スペース区切り	任意	－	２バイト文字を指定する場合は、Encodeしたものを指定する。 ※複数指定時はスペース区切り
price	旅行代金（ＭＡＸ）	任意	－	指定金額以下のものを抽出
sort_price	検索結果のソート順(旅行代金)	任意	low	low \| high
rows	検索結果の行数を指定	任意	30	検索結果の行数を指定 (MAX:30)
style_type	スタイルシートのタイプ指定	任意	－	【コード一覧】 xsl：text/xsl css：text/css
style_ref	スタイルシートを指定	任意 *1	－	スタイルシートのURI

*1…style_typ指定時は必ず指定が必要です。

●レスポンスフィールド

フィールド名	説明	出現回数
response
item		検索結果数分
course_no	コースNo	1
course_name	コース名称	1
dept_name	出発地	1
dest_name	目的地	1
point	ポイント	1
price_min	最低料金	1
price_max	最高料金	1
hakusu	宿泊数	1
term	期間	1
com_name	提供会社名	1
url	詳細ページのURL	1
privilege	特典	1
image_url_1	ツアーイメージURL１	1
image_url_2	ツアーイメージURL２	1
meal_condition	食事条件	1
invited_number	最少催行人数	1
conductor	添乗員	1
genchi_umu	現地係員	1

●サンプルレスポンス
国内旅行で関東を出発地、北海道に行くツアーの検索
http://www.travel-answer.ne.jp/vsApi/V1.0/tour_search.aspx?naigai=J&dest_code=10&&hatsu_code=104

<?xml version="1.0" encoding="utf-8" standalone="no" ?> 
<TA-WEB-API version="1.0">
 <response>
  <item>
   <course_no>HATSU07</course_no> 
   <course_name>初夏の北海道3日</course_name> 
   <dept_name>関東</dept_name> 
   <dest_name>北海道</dest_name> 
   <point>当社の還元ポイント10パーセントプレゼント</point> 
   <price_min>56200</price_min> 
   <price_max>81520</price_max> 
   <hakusu>2</hakusu> 
   <term>3</term> 
   <com_name>○×ツーリスト</com_name> 
   <url>http://venus/vstour/web/web_tour3_tour.aspx?p_company_cd=1001001&p_course_no=1829&p_date=&p_from=&p_afset=&p_AffFrom=</url> 
   <privilege /> 
   <image_url_1>http://venus/vstour/WEB/web_ImageView.aspx?p_flg=1&p_company_cd=1001001&p_course_no=1829</image_url_1> 
   <image_url_2>http://venus/vstour/WEB/web_ImageView.aspx?p_flg=2&p_company_cd=1001001&p_course_no=1829</image_url_2> 
   <meal_condition /> 
   <invited_number>1</invited_number> 
   <conductor>なし</conductor> 
   <genchi_umu>なし</genchi_umu> 
  </item>
 </response>
</TA-WEB-API>

●エラーレスポンス

エラーコード	内容
InvalidParameterError	パラメータの値が入っていないか、不正です。
InternalServerError	サーバは、処理を完了できませんでした。

InvalidParameterErrorの場合 
<?xml version="1.0" encoding="utf-8" ?> 
<Error>
<Message>InvalidParameterError</Message> 
</Error>

InternalServerErrorの場合 
<?xml version="1.0" encoding="utf-8" ?> 
<Error>
<Message>InternalServerError</Message> 
</Error>

▲このページのTOPへ

2.方面取得API ベータ版

●リクエストフィールド

フィールド名	説明	必須	初期値	備考
naigai	内外区分（国内/海外）を指定	必須	－	J：国内 W：海外

●レスポンスフィールド

フィールド名	説明	出現回数
response
item		検索結果数分
naigai	内外区分（国内/海外）	1
dest_code	方面コード	1
dest_name	方面名称	1

●サンプルレスポンス
国内の方面を取得するサンプル
http://www.travel-answer.ne.jp/vsApi/V1.0/get_dest_data.aspx?naigai=j

<?xml version="1.0" encoding="utf-8" standalone="no" ?> 
  <TA-WEB-API version="1.0">
   <response>
    <item>
     <naigai>J</naigai> 
     <dest_code>10</dest_code> 
     <dest_name>北海道</dest_name> 
    </item>
    <item>
     <naigai>J</naigai> 
     <dest_code>11</dest_code> 
     <dest_name>東北</dest_name> 
    </item>
    <item>
     <naigai>J</naigai> 
     <dest_code>12</dest_code> 
     <dest_name>関東</dest_name> 
    </item>
   </response>
  </TA-WEB-API>

●エラーレスポンス

エラーコード	内容
InvalidParameterError	パラメータの値が入っていないか、不正です。
InternalServerError	サーバは、処理を完了できませんでした。

InvalidParameterErrorの場合 
<?xml version="1.0" encoding="utf-8" ?> 
<Error>
<Message>InvalidParameterError</Message> 
</Error>

InternalServerErrorの場合 
<?xml version="1.0" encoding="utf-8" ?> 
<Error>
<Message>InternalServerError</Message> 
</Error>

▲このページのTOPへ

3.出発地取得API ベータ版

●リクエストフィールド

フィールド名	説明	必須	初期値	備考
naigai	内外区分（国内/海外）を指定	必須	－	J：国内 W：海外

●レスポンスフィールド

フィールド名	説明	出現回数
response
item		検索結果数分
naigai	内外区分（国内/海外）	1
hatsu_code	方面コード	1
hatsu_name	方面名称	1

●サンプルレスポンス
国内の出発地を取得するサンプル
http://www.travel-answer.ne.jp/vsApi/V1.0/get_hatsu_data.aspx?naigai=j

<?xml version="1.0" encoding="utf-8" standalone="no" ?> 
  <TA-WEB-API version="1.0">
   <response>
    <item>
     <naigai>J</naigai> 
     <hatsu_code>101</hatsu_code> 
     <hatsu_name>北海道</hatsu_name> 
    </item>
    <item>
     <naigai>J</naigai> 
     <hatsu_code>102</hatsu_code> 
     <hatsu_name>東北</hatsu_name> 
    </item>
    <item>
     <naigai>J</naigai> 
     <hatsu_code>103</hatsu_code> 
     <hatsu_name>北陸</hatsu_name> 
    </item>
   </response>
  </TA-WEB-API>

●エラーレスポンス

エラーコード	内容
InvalidParameterError	パラメータの値が入っていないか、不正です。
InternalServerError	サーバは、処理を完了できませんでした。

InvalidParameterErrorの場合 
<?xml version="1.0" encoding="utf-8" ?> 
<Error>
<Message>InvalidParameterError</Message> 
</Error>

InternalServerErrorの場合 
<?xml version="1.0" encoding="utf-8" ?> 
<Error>
<Message>InternalServerError</Message> 
</Error>

▲このページのTOPへ

4.旅行目的取得API ベータ版

●リクエストフィールド

なし

●レスポンスフィールド

フィールド名	説明	出現回数
response
item		検索結果数分
purpose_code	旅行目的コード	1
purpose_name	旅行目的名称	1

●サンプルレスポンス
旅行目的を取得するサンプル
http://www.travel-answer.ne.jp/vsApi/V1.0/get_purpose_data.aspx

<?xml version="1.0" encoding="utf-8" standalone="no" ?>
<TA-WEB-API version="1.0">
 <response>
  <item>
   <purpose_code>001</purpose_code>
   <purpose_name>ハネムーン</purpose_name>
  </item>
 </response>
</TA-WEB-API>

●エラーレスポンス

エラーコード	内容
InvalidParameterError	パラメータの値が入っていないか、不正です。
InternalServerError	サーバは、処理を完了できませんでした。

InvalidParameterErrorの場合 
<?xml version="1.0" encoding="utf-8" ?> 
<Error>
<Message>InvalidParameterError</Message> 
</Error>

InternalServerErrorの場合 
<?xml version="1.0" encoding="utf-8" ?> 
<Error>
<Message>InternalServerError</Message> 
</Error>

▲このページのTOPへ