機能仕様

当該機能は、機材レイアウトやシートピッチ、機内Wi-Fi有無といった機内設備、アメニティに関する情報を取得するAPIであり、300社以上の航空会社に対応しています。返却される情報はRoutehappy社独自のアルゴリズムに基づいています。1つのリクエストで最大150フライトの情報が取得可能です。

API利用上の注意事項

(1) バージョン管理に関する注意事項
本APIはバージョンの概念がありません。
そのため、Routehappy社によってタグや値に関する変更が発生した場合、変更前のレスポンスを取得できませんので、ご注意ください。

(2) 返却される値について
既存のタグの名称変更や削除はございませんが、返却値が追加・変更となる場合があります。
そのためタグ定義書に記載されていない値が返却される可能性がございますので、ご注意いただきますようお願い致します。


layouts、"display_text"タグの返却値が変更された場合の一例
変更前 変更後
 "layouts": [
      {
        "id": 1,
        "display_text": "3-4-3 seat layout",
        "quality": "standard",
        "row_layout": "3-4-3",
        "direct_aisle_access": "no",
        "type": "forward",
        "updated_at": "2016-05-19T05:01:00Z"
      }
    ]
 "layouts": [
      {
        "id": 1,
        "display_text": "basic 3-4-3 seat layout",
        "quality": "standard",
        "row_layout": "3-4-3",
        "direct_aisle_access": "no",
        "type": "forward",
        "updated_at": "2016-05-19T05:01:00Z"
      }
    ]


(3) INFINI Amenity APIに関するご注意
ご契約時に定めた1ヶ月あたりの上限リクエスト数を超過しますと、利用不可となります。
上限値の80%、90%、100%に到達しますと、登録しているメールアドレスへ自動でメールが送信されます。
アラートの閾値の変更に関しては「open-support@infini-trvl.co.jp」へご連絡ください。

(4)検証環境について
本APIに検証環境はございません。検証は本番環境にて実施をお願い致します。

 

取得情報カテゴリについて

本APIでは以下のカテゴリ情報がレスポンスで返却されます。
必要な項目をリクエストで選択が可能です。詳細はリクエストサンプルレスポンスサンプルタグ定義書をご確認ください。

<スコア>
Score Routehappy社独自の”Speed”と”Amenity”の評価に基づき1.0~10.0の点数で表示します。
Speed Routehappy社独自のフライト時間の評価を1~5(長~短)の5段階で表示します。
Amenity Routehappy社独自の各アメニティ総合評価を1~5(低~高)の5段階で表示します。

<アメニティ>
Seat 座席タイプ、シートピッチ(インチ数)、幅、リクライニング角度(上級クラスのみ)
Aircraft 機材種別(鉄道バスを含む)、気圧設備、窓のサイズ
Layout 列のレイアウト(3-4-3など)、列のすべての座席が通路に面しているか(上級クラスのみ)
Wi-Fi 利用可否、種類、回線速度、有料/無料、利用可能範囲(キャビン全体/一部)
Entertainment 利用可否、有料/無料、提供種別
Power 利用可否、提供形式(AC電源コンセント/USBポートなど)
Fresh food 機内食の有無、食事種別、有料/無料
Beverages 飲料提供の有無、飲料種別(アルコール/ノンアルコール)、有料/無料

<サマリー>
上記各アメニティ項目の一部を表示します。
Seat_summary
Aircraft_summary
Layout_summary
Wi-Fi_summary
Entertainment_summary
Power_summary
Fresh food_summary
Beverages_summary

※航空会社が情報の登録をしていない場合、情報の一部が返却されない場合があります。その場合は"n/a"の値が返却されます。
 

更新履歴

2019/06/07 仕様書初版公開


 

タグ定義書

リクエストサンプル

HTTPメソッド:GET
リクエスト条件
便名 NH184
区間 NRTHNL
出発日 2020年1月1日
キャビンクラス エコノミー
取得スコア情報 全て
取得アメニティ情報  全て
取得サマリー情報 全て
 選択/legs?ids=NRT-HNL-NH-184-20200101-ECON&include=score,amenity,speed,seat_summary,entertainment_summary,power_summary,wifi_summary,aircraft_summary,layout_summary,fresh_food_summary,segments,segments.aircraft,segments.entertainment,segments.fresh_food,segments.layout,segments.power,segments.seat,segments.wifi,segments.beverage

レスポンスサンプル

 選択{
  "data": [
    {
      "id": "NRT-HNL-NH-184-20200101-ECON",
      "links": {
        "score": 8.9,
        "amenity": 4,
        "speed": 5,
        "aircraft_summary": "37",
        "entertainment_summary": "20|10000",
        "seat_summary": "406",
        "layout_summary": "21",
        "wifi_summary": "113|10000",
        "power_summary": "6|10000",
        "fresh_food_summary": "10|10000",
        "segments": [
          "NRT-HNL-NH-184-20200101-ECON"
        ]
      }
    }
  ],
  "linked": {
    "scores": [
      {
        "id": 8.9,
        "word_score": "Excellent"
      }
    ],
    "speeds": [
      {
        "id": 5,
        "descriptor": "Shortest duration"
      }
    ],
    "amenities": [
      {
        "id": 4,
        "descriptor": "Very good"
      }
    ],
    "aircraft_summaries": [
      {
        "id": "37",
        "display_text": "A380 (jumbo)"
      }
    ],
    "entertainment_summaries": [
      {
        "id": "20|10000",
        "exists": "yes",
        "display_text": "On demand entertainment"
      }
    ],
    "seat_summaries": [
      {
        "id": "406",
        "display_text": "34\" seat pitch"
      }
    ],
    "layout_summaries": [
      {
        "id": "21",
        "display_text": "3-4-3 seat layout"
      }
    ],
    "wifi_summaries": [
      {
        "id": "113|10000",
        "exists": "yes",
        "display_text": "Basic web browsing (fee)"
      }
    ],
    "power_summaries": [
      {
        "id": "6|10000",
        "exists": "yes",
        "display_text": "Power & USB outlets"
      }
    ],
    "fresh_food_summaries": [
      {
        "id": "10|10000",
        "exists": "yes",
        "display_text": "Meal provided"
      }
    ],
    "segments": [
      {
        "id": "NRT-HNL-NH-184-20200101-ECON",
        "mk_flt_no": "184",
        "links": {
          "seat": 406,
          "wifi": 113,
          "power": 6,
          "entertainment": 20,
          "fresh_food": 10,
          "beverage": 15,
          "layout": 21,
          "aircraft": 37
        }
      }
    ],
    "seats": [
      {
        "id": 406,
        "display_text": "34\" seat pitch",
        "quality": "better",
        "legroom": "more",
        "pitch": "34",
        "width": "wider",
        "flatness": "not flat",
        "type": "above average legroom",
        "updated_at": "2016-07-18T10:24:24Z"
      }
    ],
    "wifis": [
      {
        "id": 113,
        "display_text": "Basic web browsing (fee)",
        "quality": "standard",
        "performance": "better",
        "cost": "paid",
        "exists": "yes",
        "chance": "full",
        "coverage": "full",
        "connectivity_type": "wifi",
        "type": "wifi",
        "updated_at": "2018-08-31T03:46:10Z"
      }
    ],
    "powers": [
      {
        "id": 6,
        "display_text": "Power & USB outlets",
        "quality": "better",
        "cost": "free",
        "distribution": "all",
        "multiple_at_seat": "no",
        "usb_port": "yes",
        "exists": "yes",
        "power_outlet": "yes",
        "chance": "no",
        "type": "power/usb",
        "updated_at": "2016-05-19T05:01:01Z"
      }
    ],
    "entertainments": [
      {
        "id": 20,
        "display_text": "On demand entertainment",
        "quality": "better",
        "cost": "free",
        "exists": "yes",
        "type": "on-demand",
        "updated_at": "2018-01-17T01:33:46Z",
        "offerings": {
          "delivery_medium": "in-seat",
          "content_type": "avod",
          "selection_type": "on-demand"
        }
      }
    ],
    "fresh_foods": [
      {
        "id": 10,
        "display_text": "Meal provided",
        "quality": "standard",
        "cost": "free",
        "exists": "yes",
        "type": "meal",
        "updated_at": "2019-01-07T01:32:22Z"
      }
    ],
    "beverages": [
      {
        "id": 15,
        "display_text": "Alcohol & beverages provided",
        "quality": "standard",
        "type": "alcoholic and nonalcoholic",
        "alcoholic_cost": "free",
        "nonalcoholic_cost": "free",
        "exists": "yes",
        "updated_at": "2018-06-04T03:00:40Z"
      }
    ],
    "layouts": [
      {
        "id": 21,
        "display_text": "3-4-3 seat layout",
        "quality": "standard",
        "row_layout": "3-4-3",
        "direct_aisle_access": "no",
        "type": "forward",
        "updated_at": "2016-05-19T05:01:00Z"
      }
    ],
    "aircrafts": [
      {
        "id": 37,
        "display_text": "A380 (jumbo)",
        "quality": "better",
        "model": "A380",
        "type": "jumbo",
        "cabin_pressure": "enhanced",
        "window_size": "larger",
        "updated_at": "2016-05-31T10:00:47Z"
      }
    ]
  },
  "meta": {
    "unmatched_keys": [

    ]
  }
}