ドキュメントの更新:すべての'/subscriptions'エンドポイントは、フィルタパラメータを持つ単一のList Subscriptionsエンドポイントに統合されました。
以下のCommercialAPI エンドポイントのドキュメンテーションを更新し、OpenAPI 3 の仕様要件に合わせました:
- バイヤーに割り当てられたアカウントIDでサブスクリプションを取得する
- リセラーアカウントIDでサブスクリプションを取得
両方のエンドポイントは同じ基底 URL を共有しますが、クエリパラメータによってのみ異なります。
OpenAPI 3 YAML 標準に準拠するために、現在、これらは1つのエンドポイントとしてドキュメント化されています:
リスト購読。
何が変わったのか:
- 上記のエンドポイントは、ドキュメントのリスト・サブスクリプションの下にまとめられています。
- クエリーパラメーター(buyer_assigned_account_id、reseller_account_id)は、同じエンドポイント内でフィルターとして利用できます。
- ドキュメント構造を更新し、OpenAPI 3 の要件を満たし、API ツールとの互換性を向上。
変わらなかったこと
- エンドポイントのロジックや動作に変更はない
- リクエスト/レスポンスのフォーマットに変更はない
- を使用した既存の統合:
- GET /subscriptions?buyer_assigned_account_id={buyer_assigned_account_id}
- GET /subscriptions?reseller_account_id={reseller_account_id}」は、以前とまったく同じように機能します。
は以前とまったく同じように機能する。
このアップデートはドキュメントのみの更新で、機能に影響を与えることなく、API の一貫した表現を保証するものである。