> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/transit-classic/ja/apirifarensu/wen-shulli.md).

# 文書履歴

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.payments.thalescloud.io/transit-classic/ja/apirifarensu/wen-shulli.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.