文書履歴

リリース	日付 (dd/mm/yyyy)	変更点
1.0.0	20/09/2018	TES API の初回リリース
1.0.1	01/10/2018	新しいエラーコードを追加 provisionCard が拒否された アカウントの不一致 無効な個人化データ 現在のカード状態では操作は許可されていません リクエスト/レスポンスヘッダーに timestamp の任意パラメータを追加 カード取得方法に「unknown」値を追加 cardPersoData に keyIndex パラメータを追加 updateCardState（TESからTSHへ）には新しいアクション PARK_AND_DELETE があります updateCardState（TSH から TES）には新しいアクション BLACKLIST があります updateCardState（TSH から TES）には新しいアクション BLACKLIST があります getCards で返される状態は、CREATED、ACTIVE、SUSPENDED_ISSUER、SUSPENDED_WALLET、BLACKLISTED、DELETED に更新されています
1.0.2	22/10/2018	新しい deviceType "UNKNOWN" を追加 新しいエラーコード「provisioning count exceeded」を追加 phoneNumerLastDigits の টাইポを修正し、phoneNumberLastDigits に置き換えました provisionCardレスポンスにオプションのパラメータ「displayCardNumber」を追加 updateCardState から PARK_AND_DELETE アクションを削除する（TES から TSH へ） TES がユーザーへのメッセージ配信を要求できるように、新しい API sendMessage を追加する getCards から BLACKLISTED 状態を、updateCardState（TSH→TES）から BLACKLIST アクションを削除する TES がカード口座が返金済みであることを TSH に通知できるように、新しい API refundCardAccount を追加する cardPersoData 型に関する TES から TSH への swagger の問題を修正する initiateCardSession において、PARK_CARD 操作を BLOCK_AND_READ_CARD に置き換える updateCardState（TSH→TES）について、parameter operation を newState に更新し、この呼び出しが変更を要求するのではなく変更を通知するために行われることを反映するよう、関連する値も更新する。
1.0.3	05/11/2018	orderId と purchaseId の長さを 48 ではなく 64 に増やす paymentInstrument パラメータに新しいパラメータを追加する（createCardAccound と topupCardAccount に適用） バージョン ヘッダー 署名 createCardAccount と topupCardAccount に新しい出力パラメータ「signature」を追加 responseHeader の statusCode は必須になりました 新しい API getRequestStatus と新しいエラーコード「unknow request」を追加 GDPR / RoI 準拠のための新しい LCM アクション「ERASE」を追加 新しい API getRequestStatus と新しいエラーコード「unknow request」を追加 provisionCard に customerData パラメータを追加
1.0.4	10/12/2018	旧式の API「getPurchaseStatus」と「updatePurchaseStatus」を削除 park card 用の新しい Device GW API getParkCardCommands createCardAccount と topupCardAccount 用の新しいエラーコードを追加 419 PIN が必要 420 PINが正しくありません 421 PINがロックされています updateCardState（TSHからTES）でエラー。purchaseIdはレスポンスから削除されました createCardAccountリクエストにproductIdを追加 provisionCardにcardLastDigitsを追加 交通機関通知APIのプレフィックスURLを修正（xxx/v1.0からxxx/1/0へ）
1.0.5	07/01/2019	getRequestStatus APIレスポンスからRECEIVEDステータスを削除 無効なカード情報に対する新しいエラーコード166を追加 paymentInstrument内のsignatureとpaymentDataは最大8192文字に制限されています createCardAccountおよびtopupCardAccount用に、paymentInstrumentに新しいパラメータwrappedKey（RSAアルゴリズム用）を追加
1.0.6	01/02/2019	通勤プラン管理向けに新しいメソッド updateCardMetadata を追加 getReaderModeCommands に cardContents オブジェクトパラメータを追加
1.0.7	08/02/2019	通勤プランでローカライズされたタイトルのサポートを追加
1.0.8	21/02/2019	initiateCardSession と getCardCommands の operation の可能な値を揃える
1.0.9	18/03/2019	updateCardState で新しい状態「UNLINKED」を送信可能にする（TSH から TES） UNLINKED カード状態を管理するために getCards API を更新し、今後は card account state を返すようにする provisionCard のレスポンスに新しい任意パラメータ「cardholderName」を追加
1.0.10	02/04/2019	device gateway API に新しいエラーコードを追加 172 無効なカード、サポートされていない system code 173 無効なカード、サポートされていない service 177 無効なカード、area data が無効 178 無効なカード、カード状態は in-station です
1.0.11	16/04/2019	getCards のレスポンスを更新 cardAccountId を削除 walletAccountId、cardAccountState、walletCardAccountId を最上位レベルに配置 カード所有者名のローカライズ管理のために provisionCard のレスポンスを更新 getParkCardCommands と getReaderModeCommands を更新 レスポンスに新しいパラメータ「cardData」を追加 cardData に「balanceAmount」を含める TES から TSH への API にエラーコード 221 を追加
1.0.12	24/04/2019	新しいクライアント TSM spec 2.2 を考慮するために device gateway にエラーコードを追加
1.0.13	17/05/2019	operation value「RENEW_CARD」を「UPDATE_PLAN」に名称変更
1.0.14	27/05/2019	notifyOperationResult の更新 cardId は現在任意 任意パラメータ purchaseId を追加 任意パラメータ cardAccountId を追加 パラメータ isProvisioning を追加
1.0.15	06/06/2019	walletAccountId を createCardAccount から削除（provisionCard でのみ送信）
1.0.16	23/07/2019	device gateway メソッドから retryCount を削除 エラー 922 を削除 TSH から TES へのメソッド用にエラー 432 を追加 card perso data の長さを 500 から 8192 に拡張
1.0.17	11/12/2019	checkCardAccount で指定される walletProviderId の enum 制約を削除 device-gateway と transit-tsh-to-tes に新しい HTTP ヘッダー x-actor-id を追加。このヘッダーは、リクエストを開始した wallet provider を示す。値は checkCardAccount で定義される walletProviderId に対応する
1.0.18	26/10/2020	TES に追加情報を提供するため、notifyOperationResult に新しい任意パラメータ「resultData」を追加 wallet から開始された topup に関連する場合、getCardCommands で TSH から TES に渡される新しいパラメータ「purchaseId」を追加。 provisionCard のレスポンスに新しいパラメータ「cardData」を追加。 createCardAccount と topupCardAccount のリクエストに新しい任意パラメータ「opaqueServiceProviderData」を追加。
1.0.19	30/11/2021	新しい関数 getCardAccountsMetadata を追加 新しい関数 getCardActions を追加 静的にプロビジョニングされた定義済み値を置き換えられるように、checkCardAccount のレスポンスと updateCardMetadata のリクエストに新しい任意パラメータ 'cardArtManifest' を追加 新しい関数 getAsset を追加
1.0.20	28/02/2024	静的にプロビジョニングされた定義済み値を置き換えられるように、getCardActions のレスポンス内の cardActions オブジェクトに新しいパラメータ（オブジェクトの配列）「title」を追加 追加 card data 準備に関する Calypso の真実 セクション
1.0.21	14/1/2024	'checkCardAccount' のレスポンスに新しいパラメータ 'mobileApplicationInfo' を追加
1.0.22	11/12/2025	provisionCard のレスポンスに新しい任意パラメータ 'cardArtManifest' を追加
1.0.23	21/09/2026	対象の wallet provider を示す、受信リクエスト（TES から TSH）向けの新しい任意 HTTP ヘッダーを追加。このヘッダーの値は walletProviderId に対応する（送信側 HTTP ヘッダーの場合と同様）