接続・機能仕様

 

製品概要

INFINI Calendar Cacheは1年分の各日付の空席連動型最安運賃データを一括で取得できる機能です。
INFINI Calendar Cacheのデータを利用することにより、
カレンダー形式で空き状況や最安の金額を表示することが可能となります。

※ZIPデータの容量の目安はそれぞれ以下の通りです。あくまで目安となりますので、前後する場合もございます。
 ライト版: 約74MB
 スタンダート版: 約196MB

 

接続仕様・サポート環境について

1. サーバとクライアント間の通信はHTTP/1.1の仕様に基づくHTTP プロトコルを用いるものとする。

2. 通信方式はSOAPを用いるものとする。

3. 本サービスは下記のURL で提供される。
  https://www.infini-ccache.com/api/ws/


 

更新履歴

2023/07/25 提供データ拡張
  • オープンジョー対応に伴い、ホストにリクエストしたBFMの検索条件②として新規CSVファイル「12_Request2nd」を追加いたしました
2023/02/07 提供データ拡張
  • 「01_Request」ファイル内「PVInd」に「4:公示運賃(旅客種別指定)」の区分を追加いたしました
2021/08/10 提供データ拡張
  • 「03_FareComponent」ファイルにペナルティ金額の情報取得元のデータを追加いたしました
2020/09/08 提供データ拡張
  • BFMレスポンスの旅客種別を反映した新規CSVファイル「11_ PassengerTypeConvert」を追加いたしました
  • CacheIDへ運賃種別を追加いたしました
2020/02/14 提供データ拡張
  • これまでの日本発直行区間に加えて以遠区間のデータを追加いたしました
  • Private Fare(IT運賃)のデータ取得が可能になりました
2019/09/04 初版
  • INFINI Calendar Cacheをリリースいたしました
 

リクエストサンプル(ZIPダウンロードAPI)

 選択<INFINI_CalendarCacheRQ Version="1.0.0">
	<POS> 
		<UserAuth ID="XXXX" /> 
	</POS>
</INFINI_CalendarCacheRQ>

ケース1:正常パターンのレスポンスサンプル(ZIPダウンロードAPI)

 選択<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">			
	<SOAP-ENV:Header/>			
	<SOAP-ENV:Body>			
		<INFINI_CalendarCacheRS xmlns="/" Version="1.0.0">			
			<FileData>			
				<FilePath CreateDateTime="2019-06-19 16:24:06">https://www.infini-ccache.com/api/downloadFile/Zip/CalendarCache_20190619_162406_001.zip?token=c3525c96-e298-74c8-6587-1e6a2064cf85</FilePath>
			</FileData>			
		</INFINI_CalendarCacheRS>			
	</SOAP-ENV:Body>			
</SOAP-ENV:Envelope>

ケース2:エラーパターンのレスポンスサンプル(ZIPダウンロードAPI)

 選択<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">			
	<SOAP-ENV:Header/>			
	<SOAP-ENV:Body>			
		<INFINI_CalendarCacheRS xmlns="/" Version="1.0.0">			
			<Message Code="E1002" Text="Authentication Error"/>			
		</INFINI_CalendarCacheRS>			
	</SOAP-ENV:Body>			
</SOAP-ENV:Envelope>			

ケース3:エラーパターン(複数)のレスポンスサンプル(ZIPダウンロードAPI)

 選択<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">			
	<SOAP-ENV:Header/>			
	<SOAP-ENV:Body>			
		<INFINI_CalendarCacheRS xmlns="/" Version="1.0.0">			
			<Message Code="E2001" Text="No Data"/>			
			<Message Code="E9999" Text="Exception Error"/>			
		</INFINI_CalendarCacheRS>			
	</SOAP-ENV:Body>			
</SOAP-ENV:Envelope>			

CSVサンプル

  • CSVデータファイルサンプル
    ダウンロードしてご確認ください。
 

仕様書

スキーマ