API一覧

パッケージ在庫検索API(v1)

検索条件にマッチするパッケージの在庫情報を提供します。

リクエストURL

https://api.kaifatravel.net/v1/packages

認証方式

ベーシック認証 （各旅行代理店様のログインID,PWと同じ）

入力パラメータ

項目名 パラメーター 必須 備考
ホテル地域 hCity ー 台北,高雄 のいずれか一つ指定可能
ホテルランク hRank ー A,B,C,D,E,F,G のいずれか一つ指定可能
出発日 rDate ○ 任意の1日のみ指定可能
ツアー日程 stay ○ 1〜6のいずれか一つ指定可能（1=1泊2日, 2=2泊3日, 3=3泊4日, 4=4泊5日, 5=5泊6日, 6=6泊7日）
部屋数（シングル） roomSI ○(※1) 1から10部屋まで指定可能
(※1)roomSI,roomTW,roomTRのいずれか一つが必須です。
部屋数（ツイン） roomTW ○(※1) 1から10部屋まで指定可能
(※1)roomSI,roomTW,roomTRのいずれか一つが必須です。
部屋数（トリプル） roomTR ○(※1) 1から10部屋まで指定可能
(※1)roomSI,roomTW,roomTRのいずれか一つが必須です。

出力パラメータ（出力形式=json）

分類 項目名 パラメーター 備考
全体情報
pagingInfo		 検索結果総数 recordCount 検索結果のレコード件数
パッケージ情報
packages		 ホテルID hotelId
〃 都市 hotelCity
〃 ホテルランク hotelRank
〃 ホテル名 hotelName
〃 ホテル名カナ hotelNameKana
〃 ホテル住所 address
〃 ホテル座標（緯度） latitude
〃 ホテル座標（経度） longitude
〃 基本料金 charge
〃 基本料金通貨単位 currencyUnit 円 or 台湾ドル（ログインIDにより可変）
〃 在庫数 allot

リクエスト例

出発日=2019/06/01,ツアー日程=2泊3日, シングル=1部屋,都市=台北,ホテルランク=Cを検索する場合

リクエストURL（要ベーシック認証）
https://api.kaifatravel.net/v1/packages?rDate=2019-06-01&stay=2&roomSI=1&hCity=台北&hRank=C
結果
{
    "pagingInfo": {
        "recordCount": 5
    },
    "packages": [
        {
            "hotelId": "1012",
            "hotelCity": "台北",
            "hotelRank": "C",
            "hotelName": "中源大飯店",
            "hotelNameKana": "ニューコンチネンタル・ホテル",
            "address": "台北市大同区重慶北路一段73番",
            "latitude": 25.052315,
            "longitude": 121.514253,
            "charge": 9700,
            "currencyUnit": "円",
            "allot": 4
        },
        {
            "hotelId": "1016",
            "hotelCity": "台北",
            "hotelRank": "C",
            "hotelName": "台北馥敦（南京館）",
            "hotelNameKana": "タイペイフラートンホテルイースト",
            "address": "台北市松山区南京東路五段32号",
            "latitude": 25.051326,
            "longitude": 121.558937,
            "charge": 9700,
            "currencyUnit": "円",
            "allot": 2
        },
        {
            "hotelId": "1062",
            "hotelCity": "台北",
            "hotelRank": "C",
            "hotelName": "馥華商旅（松江館）",
            "hotelNameKana": "フォワードホテル タイペイ ",
            "address": "台北市中山区一江街3号",
            "latitude": 25.050757,
            "longitude": 121.531559,
            "charge": 9700,
            "currencyUnit": "円",
            "allot": 1
        },
        {
            "hotelId": "1017",
            "hotelCity": "台北",
            "hotelRank": "C",
            "hotelName": "慶泰大飯店",
            "hotelNameKana": "ガーラホテル",
            "address": "台北市中山区松江路186号",
            "latitude": 25.056566,
            "longitude": 121.532883,
            "charge": 11000,
            "currencyUnit": "円",
            "allot": 3
        },
        {
            "hotelId": "1014",
            "hotelCity": "台北",
            "hotelRank": "C",
            "hotelName": "康華大飯店",
            "hotelNameKana": "ゴールデンチャイナホテル",
            "address": "台北市中山区松江路306号",
            "latitude": 25.060161,
            "longitude": 121.533014,
            "charge": 11000,
            "currencyUnit": "円",
            "allot": 2
        }
    ]
}

エラー

エラー内容はHTTPステータスコードとレスポンスボディから判断できます。

HTTPステータスコード 意味 レスポンスボディ例 (JSON)
400 パラメーターエラー 
{"error": "wrong_parameter", "error_description": "rDateを指定してください。"}
404 対象のデータが存在しなかった場合 
{"error": "not_found", "error_description": "not found"}

ホテル在庫検索API(v1)

検索条件にマッチするホテルの在庫情報を提供します。

リクエストURL

https://api.kaifatravel.net/v1/hotels

認証方式

ベーシック認証 （各旅行代理店様のログインID,PWと同じ）

入力パラメータ

項目名 パラメーター 必須 備考
ホテル地域 hCity ー 台北,高雄 のいずれか一つ指定可能
ホテルランク hRank ー A,B,C,D,E,F,G のいずれか一つ指定可能
宿泊日 rDate ○ 任意の1日のみ指定可能
宿泊日程 stay ○ 1〜6のいずれか一つ指定可能（1=1泊2日, 2=2泊3日, 3=3泊4日, 4=4泊5日, 5=5泊6日, 6=6泊7日）
部屋数（シングル） roomSI ○(※1) 1から10部屋まで指定可能
(※1)roomSI,roomTW,roomTRのいずれか一つが必須です。
部屋数（ツイン） roomTW ○(※1) 1から10部屋まで指定可能
(※1)roomSI,roomTW,roomTRのいずれか一つが必須です。
部屋数（トリプル） roomTR ○(※1) 1から10部屋まで指定可能
(※1)roomSI,roomTW,roomTRのいずれか一つが必須です。

出力パラメータ（出力形式=json）

分類 項目名 パラメーター 備考
全体情報
pagingInfo		 検索結果総数 recordCount 検索結果のレコード件数
ホテル情報
hotels		 ホテルID hotelId
〃 都市 hotelCity
〃 ホテルランク hotelRank
〃 ホテル名 hotelName
〃 ホテル名カナ hotelNameKana
〃 ホテル住所 address
〃 ホテル座標（緯度） latitude
〃 ホテル座標（経度） longitude
〃 基本料金 charge
〃 基本料金通貨単位 currencyUnit 円 or 台湾ドル（ログインIDにより可変）
〃 在庫数 allot

リクエスト例

出発日=2019/06/01, 宿泊日程=2泊3日, ツイン=1部屋, 都市=高雄 を検索する場合

リクエストURL（要ベーシック認証）

https://api.kaifatravel.net/v1/hotels?rDate=2019-06-01&stay=2&roomTW=1&hCity=高雄

結果

{
    "pagingInfo": {
        "recordCount": 2
    },
    "hotels": [
        {
            "hotelId": "1102",
            "hotelCity": "高雄",
            "hotelRank": "A",
            "hotelName": "高雄 立多商旅",
            "hotelNameKana": "ベストホテル 高雄",
            "address": "高雄市三民区九如二路161号",
            "latitude": 22.640652,
            "longitude": 120.309092,
            "charge": 11000,
            "currencyUnit": "円",
            "allot": 2
        },
        {
            "hotelId": "1113",
            "hotelCity": "高雄",
            "hotelRank": "D",
            "hotelName": "COZZI高雄中山館",
            "hotelNameKana": "ホテルコッツィ 高雄中山館",
            "address": "高雄市前鎮区中山二路260号30樓",
            "latitude": 22.613314,
            "longitude": 120.305456,
            "charge": 18000,
            "currencyUnit": "円",
            "allot": 1
        }
    ]
}

エラー

エラー内容はHTTPステータスコードとレスポンスボディから判断できます。

HTTPステータスコード 意味 レスポンスボディ例 (JSON)
400 パラメーターエラー 
{"error": "wrong_parameter", "error_description": "rDateを指定してください。"}
404 対象のデータが存在しなかった場合 
{"error": "not_found", "error_description": "not found"}