厳密に型指定された API スキーマを使用して AWS Marketplace Catalog API (CAPI) の統合を簡素化する
Catalog API (CAPI) の StartChangeSet、DescribeChangeSet、DescribeEntity API で使用される DetailsDocument のスキーマをホストする GitHub ライブラリの導入を発表します。この新機能は、Catalog API を使用する開発者の統合プロセスを簡素化することを目的としています。
現在、販売者/パートナー組織の開発者は、価格ディメンションの追加などの操作のために Catalog API と統合するときに、API リクエスト構造を手動で構築する必要があります。これには、API ドキュメントを確認し、リクエストの「DetailsDocument」のスキーマを理解するための実験が必要です。新しいスキーマライブラリを使用すると、ドキュメントを参照したり JSON 構造を試したりしなくても、Java ライブラリと Python ライブラリを直接インポートして、厳密に型指定された応答を作成できます。これにより、時間を節約し、統合テストと実装の両方におけるエラーのリスクを軽減できます。さらに、DetailsDocument スキーマに変更があった場合は、新しいバージョンのライブラリをダウンロードし、変更を確認して、コードに必要な更新を行うだけです。この新機能は、StartChangeSet API、DescribeChangeSet API、DescribeEntity API の「Details」属性での文字列オブジェクトの送受信とともに使用されます。すでにこれらの API と統合している場合は、引き続き「Details」属性を使用できます。新規に参加する販売者や、新しい API アクションを導入する販売者に対しては、Catalog API との統合を迅速に行うためにスキーマライブラリを使用することが推奨されています。
シェイプライブラリをダウンロードして使用する方法については、StartChangeSet API、DescribeChangeSet API、および DescribeEntity API を参照してください。