Vereinfachen Sie die Integration der AWS Marketplace Catalog API (CAPI) mit stark typisierten API-Schemas

Veröffentlicht am: 19. Juli 2024

Wir freuen uns, die Einführung einer GitHub-Bibliothek ankündigen zu können, die die Schemas für das DetailsDocument hosten wird, das in den APIs StartChangeSet, DescribeChangeSet und DescribeEntity in der Catalog API (CAPI) verwendet wird. Dieses neue Feature soll den Integrationsprozess für Entwickler vereinfachen, die mit der Catalog API arbeiten.

Aktuell müssen Sie als Entwickler in Verkäufer-/Partnerorganisationen die API-Anforderungsstruktur manuell erstellen, wenn Sie die Catalog API für Operationen wie das Hinzufügen von Preisdimensionen integrieren. Dazu müssen Sie die API-Dokumentation lesen und Tests durchführen, um das Schema des von „DetailsDocument“ für die Anforderung zu verstehen. Mit der neuen Schemabibliothek können Sie die Java- und Python-Bibliotheken direkt importieren. Sie können eine stark typisierte Antwort erstellen, ohne auf die Dokumentation zurückgreifen oder mit der JSON-Struktur experimentieren zu müssen. Dies spart Zeit und reduziert das Fehlerrisiko sowohl beim Integrationstest als auch bei der Implementierung. Außerdem können Sie bei Änderungen am DetailsDocument-Schema einfach die neue Version der Bibliothek herunterladen, die Änderungen überprüfen und die erforderlichen Aktualisierungen am Code vornehmen. Diese neue Funktionalität wird neben dem Senden und Empfangen eines String-Objekts im Attribut „Details“ der APIs StartChangeSet, DescribeChangeSet und DescribeEntity verfügbar sein. Wenn Sie diese APIs bereits integriert haben, können Sie das Attribut „Details“ weiterhin verwenden. Verkäufern, die gerade den Onboarding-Prozess durchlaufen, und Verkäufern, die neue API-Aktionen integrieren, wird jedoch empfohlen, die Schemabibliothek zu verwenden, um die Integration mit der Catalog API zu beschleunigen.

Informationen zum Herunterladen und Verwenden der Shape-Bibliothek finden Sie unter StartChangeSet API, DescribeChangeSet API und DescribeEntity API.