SDK と開発者ツール
OpenAPI と API リファレンス
自動生成クライアントや開発者ツールのために、機械可読な契約を維持します。
信頼できる唯一の情報源
ルートのスキーマ、サンプル、認証、エラーオブジェクトは、公開されている OpenAPI 契約と対応している必要があります。
バージョン管理
破壊的変更には、新しい API バージョンまたは互換性の計画が必要です。
自動生成クライアントや開発者ツールのために、機械可読な契約を維持します。
ルートのスキーマ、サンプル、認証、エラーオブジェクトは、公開されている OpenAPI 契約と対応している必要があります。
破壊的変更には、新しい API バージョンまたは互換性の計画が必要です。