ドキュメント履歴

リリース	日付 (dd/mm/yyyy)	変更点
1.0.0	20/09/2018	TES API の初版リリース
1.0.1	01/10/2018	新しいエラーコードを追加 provisionCard の拒否 アカウント不一致 無効なパーソ化データ 現在のカード状態では操作は許可されていません リクエスト/レスポンスヘッダにタイムスタンプのオプションパラメータを追加 カード取得方法に '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 (TES -> TSH) から PARK_AND_DELETE アクションを削除 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) のパラメータ 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" を削除 パークカード用の新しい 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 に RSA アルゴリズムで使用される wrappedKey パラメータを追加
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	新しい状態 "UNLINKED" が updateCardState (TSH -> TES) で送信可能に UNLINKED カード状態を管理するために getCards API を更新し、カード口座状態を返すようになりました provisionCard レスポンスに新しいオプションパラメータ "cardholderName" を追加
1.0.10	02/04/2019	デバイスゲートウェイ API に新しいエラーコードを追加 172 無効なカード、サポートされていないシステムコード 173 無効なカード、サポートされていないサービス 177 無効なカード、無効なエリアデータ 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 仕様 2.2 を考慮するためにデバイスゲートウェイにエラーコードを追加
1.0.13	17/05/2019	operation 値 "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	デバイスゲートウェイメソッドから retryCount を削除 エラー 922 の削除 TSH -> TES メソッドに対するエラー 432 を追加 カードパーソデータ長を500から8192に増加
1.0.17	11/12/2019	checkCardAccount で提供される walletProviderId の列挙制約を削除 device-gateway と transit-tsh-to-tes に新しい HTTP ヘッダ x-actor-id を追加。このヘッダはリクエストを開始するウォレットプロバイダを示します。その値は checkCardAccount で定義された walletProviderId に対応します
1.0.18	26/10/2020	notifyOperationResult に TES に追加情報を渡すための新しいオプションパラメータ "resultData" を追加 ウォレットから開始されたチャージに関連する場合、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" を追加 追加 カードデータ準備における Calypso の真実 セクション
1.0.21	14/1/2024	checkCardAccount レスポンスに新しいパラメータ 'mobileApplicationInfo' を追加
1.0.22	11/12/2025	provisionCard レスポンスに新しいオプションパラメータ 'cardArtManifest' を追加