> 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/ecom/ja/d1-apiwosuru/d1-apino.md).

# D1 APIの概要

### API設計

#### データ形式

リクエストとレスポンスはJSONを使用します。文字列のエンコーディングは特に記載がない限りUTF-8です。

#### トランスポートプロトコル

すべてのインターフェースはHTTPSを使用します。相互TLS（mTLS）とOAuth 2.0が必要です。

### 下位互換性ルール

これらのルールは、D1 APIの進化に伴っても動作し続ける統合を構築するのに役立ちます。

* 未知のフィールドを受け入れる。Thalesは追加することがあります **任意** ヘッダー、URL、およびボディにおけるパラメータ。新しいフィールドが現れても統合が壊れてはなりません。

{% hint style="info" %}
「厳密な検証」は、現在の仕様バージョンにないフィールドを含むリクエストやレスポンスを拒否します。
{% endhint %}

* エラーメッセージの文字列は情報提供目的として扱ってください。固定の形式に依存しないでください。
* 時間とともに要件が変更されることを想定してください：
  * D1レスポンス内のパラメータはからに変わることがあります **任意** へ **必須**.
  * イシュアからのリクエスト内のパラメータはからに変わることがあります **必須** へ **任意**.
* JSONフィールドの順序を無視してください。
* 新しい列挙値を受け入れてください。
* 新しいAPI操作（リソースおよびHTTPメソッド）を想定してください。
* レスポンスに新しいHTTPステータスコードが含まれることを想定してください。

### APIパラメータ/操作の廃止（EOL）

Thalesは、廃止予定のAPIパラメータまたはAPI操作の廃止前に少なくとも9か月の通知を行います。

廃止期間が終了した後は、本番環境を含むすべての環境で廃止されたパラメータおよび操作の使用を停止する必要があります。

Thalesは次の条件に限定されることなく、廃止期間を短縮する場合があります：

* 重大なセキュリティリスク
* 重大な経済的または実質的な技術的影響
* 適用法または決済ネットワークからの要件

廃止されたAPIパラメータおよび操作は、ドキュメントで廃止済みとしてマークされます。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payments.thalescloud.io/ecom/ja/d1-apiwosuru/d1-apino.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.