D1 APIの概要

D1 API のデータ形式、転送、互換性ルール、および廃止ポリシー。

API設計

データ形式

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

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

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

下位互換性ルール

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

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

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

• エラーメッセージの文字列は情報提供目的として扱ってください。固定の形式に依存しないでください。

• 時間とともに要件が変更されることを想定してください：

  • D1レスポンス内のパラメータはからに変わることがあります 任意 へ 必須.

  • イシュアからのリクエスト内のパラメータはからに変わることがあります 必須 へ 任意.

• JSONフィールドの順序を無視してください。

• 新しい列挙値を受け入れてください。

• 新しいAPI操作（リソースおよびHTTPメソッド）を想定してください。

• レスポンスに新しいHTTPステータスコードが含まれることを想定してください。

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

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

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

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

• 重大なセキュリティリスク

• 重大な経済的または実質的な技術的影響

• 適用法または決済ネットワークからの要件

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