API-Onboarding

~8 Min. Lesezeit Januar 23, 2026

Prime Video bietet Partnern zwei umfassende API-Suiten, die entwickelt wurden, um das Inhaltsmanagement zu optimieren und wertvolle Geschäftsinformationen zu liefern. In diesem Handbuch wird der komplette Onboarding-Prozess sowohl für die Content API Suite als auch für die Analytics API Suite beschrieben, einschließlich der Authentifizierungsanforderungen, der technischen Einrichtung und der wichtigsten Unterschiede zwischen den beiden.


Onboarding in die Content API Suite

Schritt 1: Zugriff anfordern und Zugangsdaten generieren

Wenden Sie sich an Ihren Prime Video-Kontakt oder stellen Sie über Kontakt eine Zugriffsanfrage, um den Zugriff in der Content API Suite anzufordern.

Schritt 2: Zugangsdaten generieren und absenden

Sobald Ihre Zugriffsanfrage genehmigt wurde, generieren Sie für jede Umgebung einen privaten Schlüssel und eine Certificate Signing Request (CSR) und teilen Sie diese mit Ihrem Prime Video-Ansprechpartner.

Ihre CSR generieren
Sie können jedes Zertifikatstool verwenden, um Ihre CSRs zu generieren. Wenn Sie OpenSSL verwenden möchten, können Sie die folgenden beiden Befehle ausführen:

Ihre CSR an Ihren Prime Video-Kontakt senden
Die CSR enthält alle Informationen, die wir benötigen, um Ihr API-Zertifikat zu generieren. Dies ist die Datei, die Sie Ihrem Kontakt als Teil Ihrer Onboarding-Anfrage senden. Sobald Prime Video Ihre CSR erhalten hat, benötigen Sie diese Datei nicht mehr.

Hinweis: Es ist sehr wichtig, dass Sie Ihre privaten Schlüsseldateien sicher aufbewahren und niemals an Dritte weitergeben, auch nicht an Prime Video. Wir werden niemals nach dieser Datei fragen. Sie werden sie später verwenden, wenn Sie Ihre API-Aufrufe an uns tätigen.

Schritt 3: Ihre Zugangsdaten erhalten

Sobald Ihre Anfrage genehmigt wurde, erhalten Sie vom Prime Video-Team eine E-Mail mit den folgenden Informationen:

  • Das öffentliche Zertifikat, das Sie für Aufrufe an uns verwenden.
  • Ihr API-Schlüssel für Anfrageheader
  • Die URL-Endpunkte für die API-Aufrufe.
  • Informationen über das TPS, für das Sie mit Ihrem Zertifikat konfiguriert sind.

Schritt 4: Ihre Integration konfigurieren

Herzlichen Glückwunsch! Sie können jetzt Ihren privaten Schlüssel, Ihr öffentliches Zertifikat und Ihren API-Schlüssel verwenden, um die API aufzurufen. Hier sind einige Beispiele für Integrationen, die verschiedene Technologien verwenden:

Bash

Python

Node.js

Schritt 5: Ihre Integration testen

Für die Avails API bieten wir Testsupport an, um sicherzustellen, dass Sie Avails erfolgreich über die API einreichen, aktualisieren und ablaufen lassen können. Da sich diese Vorgänge direkt auf die Ressourcen auswirken (nicht nur auf den Datenabruf), empfehlen wir allen Partnern dringend, ihre Integration gründlich zu testen. Da die APIs Offer Status und Asset Status schreibgeschützt sind, können Sie sie mit dem Produktionskonto testen.

Schritt 6: Beginnen, die API zu verwenden

Herzlichen Glückwunsch! Ihre Tests sind abgeschlossen und validiert. Sie können jetzt beginnen, die Produktionsumgebung mit Ihren Produktionszugangsdaten zu verwenden, um Ihre Inhalte auf Prime Video zu verwalten. Ihre Integration ist bereit, Ihre Inhaltsabläufe zu optimieren und Ihren Katalog in Echtzeit einzusehen.

Häufig gestellte Fragen zu Inhalts-APIs


Onboarding in Analytics API Suite

Schritt 1: Ihr Sicherheitsprofil erstellen

Im Rahmen dieses Schritts richten Sie die Zugangsdaten für die Anwendung ein und konfigurieren Sie Ihre Authentifizierungseinstellungen über die Entwicklerkonsole von Amazon.

Ihre Anwendung registrieren

  1. Navigieren Sie zur Amazon Developer Console, um den Registrierungsprozess zu starten
  2. Melden Sie sich mit Ihrem bestehenden Amazon-Entwicklerkonto an oder erstellen Sie ein neues Konto, falls Sie noch keines haben
  3. Klicken Sie auf Neues Sicherheitsprofil erstellen, um mit der Konfiguration der Authentifizierungseinstellungen Ihrer Anwendung zu beginnen
Login to AmazonDeveloper.png

Mein Profil konfigurieren

  1. Sicherheitsprofilname: Wählen Sie einen aussagekräftigen Namen, der Ihre Integration eindeutig identifiziert (z. B. „Leistungsdatenintegration“ oder „Analytics-API-Zugang“)
  2. Beschreibung: Erläutern Sie klar und deutlich den Zweck Ihrer Anwendung und wie sie die Analytics-APIs verwenden wird
  3. URL der Datenschutzerklärung: Fügen Sie eine URL hinzu, die den Benutzenden erklärt, wie Ihre Anwendung mit ihren Daten umgeht und sie schützt
  4. Klicken Sie auf Speichern, um Ihr Sicherheitsprofil zu erstellen
  5. Nach der korrekten Einrichtung sollten Sie eine Erfolgsmeldung erhalten
Security Profile Management.png

Meine Weiterleitungs-URL festlegen

  1. Gehen Sie zu Ihrem Profil und wählen Sie die Registerkarte Sicherheitsprofile aus, um Ihr neu erstelltes Sicherheitsprofil zu verwalten:
  2. Wählen Sie dann Webeinstellungen, um das Weiterleitungsverhalten Ihrer Anwendung zu konfigurieren
  3. Fügen Sie Ihre Weiterleitungs-URL hinzu – Dies ist der sichere Endpunkt, an den Benutzende nach der Autorisierung Ihrer Anwendung gesendet werden (für die lokale Entwicklung muss https:// oder https://localhost verwendet werden)
Security Profile Management 2.png

Wichtig: Speichern Sie diese URL sicher – Sie müssen im nächsten Schritt genau diese URL verwenden, wenn Sie Ihren Autorisierungscode generieren.

Ihre Zugangsdaten erhalten

  1. Navigieren Sie zur Registerkarte Webeinstellungen, um auf Ihre Anwendungszugangsdaten zuzugreifen
  2. Kopieren Sie Ihre Client-ID (diese dient als eindeutige Kennung Ihrer Anwendung) und Client Secret (dies dient als Passwort Ihrer Anwendung)
  3. Speichern Sie beide Zugangsdaten sicher im Geheimmanagementsystem Ihrer Organisation – diese werden zur Authentifizierung all Ihrer API-Anfragen verwendet

Schritt 2: Ihre Anwendung autorisieren

Im Rahmen dieses Schritts autorisieren Sie Ihre Anwendung, im Namen Ihrer Organisation auf Prime Video Slate zuzugreifen, und legen Sie die Berechtigungen fest, die zum Abrufen von Leistungsdaten und Analysen über die APIs erforderlich sind.

Ihre Anwendung zu Slate hinzufügen

  1. Melden Sie sich mit den Zugangsdaten Ihrer Organisation bei Ihrem Prime Video Slate-Konto an
  2. Navigieren Sie in der oberen rechten Ecke zu Kontoeinstellungen und wählen Sie dann Anwendungen aus dem Drop-down-Menü
Slate Applications.png

  1. Klicken Sie auf Anwendung hinzufügen, um den Autorisierungsvorgang zu starten
Add applications.png

  1. Geben Sie Ihre Kunden-ID (aus Schritt 1) in das dafür vorgesehene Feld ein
  2. Wählen Sie das Kontrollkästchen Berichte aus, um Ihrer Anwendung Zugriff auf Leistungsdaten und Berichte zu gewähren
  3. Klicken Sie auf Anwendung hinzufügen, um die Registrierung in Slate abzuschließen

Ihren Autorisierungscode generieren

  1. Erstellen Sie Ihre Autorisierungs-URL, indem Sie die Platzhalter in Klammern durch Ihre tatsächlichen Zugangsdaten aus Schritt 1 ersetzen:

  1. Öffnen Sie diese URL in Ihrem Webbrowser, um den Autorisierungsablauf zu starten
  2. Melden Sie sich mit Ihren Slate-Kontozugangsdaten an, wenn Sie dazu aufgefordert werden
  3. Überprüfen Sie die Berechtigungen, die Ihre Anwendung anfordert und klicken Sie dann auf Zulassen, um Zugriff zu gewähren
  4. Nach der Autorisierung werden Sie zu Ihrer angegebenen Weiterleitungs-URL weitergeleitet. Kopieren Sie den Autorisierungscode aus der Abfragezeichenfolge der URL (er wird angezeigt als

Bewährtes Verfahren: Wir empfehlen, ein eigenes Slate-Konto (z. B. api_access@yourcompany.com) mit den minimal erforderlichen Berechtigungen speziell für den API-Zugriff zu erstellen. Dieser Ansatz erhöht die Sicherheit und erleichtert die Verwaltung und Prüfung der API-Nutzung in Ihrem Unternehmen.

Hinweis: Wenn Sie die Berechtigungen des oder der autorisierenden Nutzenden für die Verwendung von Berichten entfernen, ist auch die Anwendung berechtigt, gesperrte Berichte zu verwenden.

Schritt 3: Ihre Zugriffstoken anfordern

Im Rahmen dieses Schritts verwenden Sie Ihren Autorisierungscode, um die Token zu erhalten, die für authentifizierte API-Aufrufe erforderlich sind. Das Zugriffstoken ermöglicht es Ihrer Anwendung, Leistungsdaten abzurufen, während das Aktualisierungstoken es Ihnen ermöglicht, neue Zugriffstoken zu generieren, ohne den Autorisierungsprozess zu wiederholen.

Autorisierungscodes sind einmalig verwendbare Token. Wenn sie zum Abrufen eines access_token verwendet werden, wird ein refresh_token zurückgegeben, das wiederum zum Abrufen des nächsten access_token verwendet werden kann. Der folgende Abschnitt führt Sie durch den Abruf Ihres ersten refresh_token.

Erste Token-Anfrage (nur beim ersten Mal):
Um ein Token anzufordern:

  1. Geben Sie client_id, client_secret, authorization_code und grant_type als URL-kodierte Formulardaten ein.
  2. Stellen Sie eine HTTP-Anfrage.
    Der curl-Befehl zum Generieren von Tokens aus authorization_code wird im folgenden Beispiel gezeigt.

Aktualisieren Ihrer Zugriffstoken:
Verwenden Sie für alle nachfolgenden Sitzungen nach Ihrer ersten Token-Anfrage Ihr Aktualisierungstoken, um neue Zugriffstoken zu erhalten:

Schritt 4: Ihre Anwendung konfigurieren

Herzlichen Glückwunsch! Sie haben jetzt alle Zugangsdaten, die Sie zum Aufrufen der Performance-APIs benötigen. Im Rahmen dieses Schritts konfigurieren Sie Ihre Anwendung so, dass Ihr Zugriffstoken in den Autorisierungsheader jeder API-Anfrage aufgenommen wird, sodass Sie Abonnementdaten, Leistungskennzahlen und Analysen für Ihre Inhalte abrufen können.

Beispiel für eine API-Anfrage:


Dieses Beispiel zeigt, wie Sie Ihre Anfragen authentifizieren – ersetzen Sie durch das tatsächliche Zugriffstoken, das Sie in Schritt 3 erhalten haben. Sie können dieses Authentifizierungsmuster jetzt verwenden, um auf alle verfügbaren Performance-API-Endpunkte zuzugreifen und die Datensatzdateien, die nur angehängt werden können, abzurufen, die granulare Daten für Ihre Analytics-Pipelines enthalten.

Schritt 5: Integration testen

Wir empfehlen allen Partnern dringend, ihre Integration gründlich zu testen, um einen zuverlässigen Zugriff auf Leistungsdaten zu gewährleisten. Im Rahmen dieses Schritts überprüfen Sie, ob Ihr Authentifizierungsablauf ordnungsgemäß funktioniert, Ihre API-Aufrufe die erwarteten Daten zurückgeben und Ihre Fehlerbehandlung ordnungsgemäß konfiguriert ist.

Schritt 6: Mit der Verwendung beginnen

Sobald Ihre Tests abgeschlossen sind und Sie bestätigt haben, dass Ihre Integration zuverlässig funktioniert, können Sie die Produktionsumgebung verwenden, um Leistungsdaten und Analysen für Ihre Inhalte auf Prime Video in Echtzeit abzurufen. Ihre Datenpipelines können jetzt die Datensatzdateien, die nur angehängt werden können, verwenden, um die granularen Analysen durchzuführen, die Ihr Unternehmen benötigt.

Lesen Sie mehr über die Analytics-API-Datenframeworks, die hier verfügbar sind:

  1. Leistungsdatensätze
  2. Berichte
  3. Finanzbericht
  4. Abonnement-Ereignisprotokoll

Häufig gestellte Fragen zu Analytics-APIs

Brauchen Sie noch Hilfe?

Kontaktieren Sie uns

In diesem Leitfaden



Interner Ferhler! Bitte erneut versuchen
Die Sitzung ist abgelaufen.

Melden Sie sich an, um fortzufahren.

Anmelden
edit