Notifications API

~7 Min. Lesezeit April 9, 2026

Mit der Notifications API können Sie Echtzeitbenachrichtigungen zu verschiedenen Inhaltsereignissen auf Prime Video erhalten – so müssen Sie Status-APIs nicht mehr wiederholt abfragen. Richten Sie automatisierte Workflows ein, die sofort auf Aktualisierungen bei der Bereitstellung von Assets und Live-Statusänderungen reagieren, sodass Sie Probleme schneller beheben und Ihren Katalog auf dem neuesten Stand halten können.


Problemerkennung in Echtzeit – Erhalten Sie sofortige Benachrichtigungen, wenn die Bereitstellung von Bestands-Assets fehlschlägt oder sich der Live-Status ändert, sodass Sie Probleme umgehend beheben kannst, anstatt sie erst Stunden oder Tage später bei manuellen Überprüfungen zu entdecken.

Reduzierter API-Overhead – Machen Sie ständige Abfragen von Status-APIs überflüssig, senken Sie so Ihre Infrastrukturkosten und das Volumen der API-Aufrufe und sorgen Sie dennoch für stets aktuelle Informationen.

Automatisierte Workflow-Integration – Verbinden Sie Benachrichtigungen direkt mit Ihren bestehenden Systemen (AWS-Services oder Webhooks), um automatisierte Antworten, die Erstellung von Tickets oder Alarm-Workflows ohne manuellen Eingriff auszulösen.

Umfassende Event-Berichterstattung – Überwachen Sie den Status der Asset-Bereitstellung sowie die Live-Status für alle Ihre Titel und Regionen über ein einziges Benachrichtigungssystem.

Erste Schritte
Um mit Benachrichtigungen zu beginnen, sind drei Schritte erforderlich:

  1. Ein Ziel registrieren: Richten Sie ein, wo Sie Benachrichtigungen erhalten möchten. Sie können zwischen AWS-Services (SQS, SNS, EventBridge) oder HTTPS-Webhooks wählen.
  2. Abonnements erstellen: Ordnen Sie die Ereignisse, die Sie überwachen möchten, Ihren registrierten Zielen zu. Jedes Abonnement deckt ein Thema ab (AssetStatus oder OfferStatus), aber Sie können innerhalb dieses Themas mehrere Ereignistypen abonnieren.
  3. Benachrichtigungen erhalten: Nach der Konfiguration erhalten Sie automatisch Benachrichtigungen in Echtzeit, wenn Ereignisse eintreten.

Verfügbare Themen und Veranstaltungen

Themen gruppieren verwandte Ereignisse zusammen. Wenn Sie ein Abonnement erstellen, wählen Sie ein Thema aus und geben Sie an, welche Ereignisse innerhalb dieses Themas Sie überwachen möchten.

LiveStatusUpdated
Thema:
Informiert Sie, wenn sich der Live-Status eines Titels auf der Prime-Video-Storefront ändert – d. h. wenn ein Titel live geht oder sich zu nicht live ändert.
Was löst diese Benachrichtigung aus? Der Live-/Nicht-Live-Status eines Titels ändert sich auf der Storefront. Verwenden Sie die callbackUrl in den Nutzdaten, um vollständige Angebotsstatusdetails über die Angebotsstatus-API abzurufen.

Nutzdaten:

AssetStatusUpdated
Thema:
Benachrichtigt Sie, sobald ein Asset ein endgültiges Bereitstellungsergebnis erreicht hat. Eine Benachrichtigung wird gesendet, wenn der Status eines Assets wie folgt lautet:

  • Versendet – das Asset wurde erfolgreich bereitgestellt, oder
  • Fehlgeschlagen – das Asset konnte nicht bereitgestellt werden oder muss bearbeitet werden.

Was löst diese Benachrichtigung aus? Eine Änderung des Bereitstellungsstatus eines Assets (z. B. Video, Audio, Untertitel, Bildmaterial). Verwenden Sie die callbackUrl, um den vollständigen Status der Asset-Bereitstellung abzurufen, einschließlich detaillierter Fehlerinformationen, sofern zutreffend.

Anwendungsfälle:

  • Erkennen Sie Fehler bei der Bereitstellung in Echtzeit und lösen Sie automatisierte Workflows für die erneute Lieferung aus
  • Bestätigen Sie die erfolgreiche Asset-Verarbeitung, ohne die Asset-Status-API abzufragen
  • Integrieren Sie es in interne Ticketsysteme, um Probleme sofort zu lösen

Nutzdaten:


Anfrage- und Antwortschemas

Dieser Abschnitt enthält technische Spezifikationen für Entwickelnde zur Integration der Partner Notification API in Ihre Systeme. Verwenden Sie diese Referenz, um das Anfrageformat, die Antwortstruktur und die von der API zurückgegebenen Datentypen zu verstehen.

Basis-URL
Alle API-Anfragen werden an die folgende Basis-URL gestellt. Fügen Sie bei der Übermittlung von Anfragen den entsprechenden Endpunktpfad an diese URL an.

Zielmanagement
Ein Ziel ist der Ort, an dem Sie Benachrichtigungen erhalten möchten – dies kann ein AWS-Service (SQS, SNS oder EventBridge) oder ein HTTPS-Webhook-Endpunkt sein. Sie müssen mindestens ein Ziel registrieren, bevor Sie Abonnements erstellen können.

Ziel registrieren


Erstellen Sie ein neues Benachrichtigungsziel, an das Ereignisbenachrichtigungen gesendet werden sollen.

Anfragetext:

Antwort:

Alle Ziele auflisten
Verwenden Sie diesen Endpunkt, um eine vollständige Liste der für Ihre Organisation registrierten Benachrichtigungsempfänger abzurufen. Dies ist nützlich, um Ihre aktuelle Konfiguration zu überprüfen oder Ziel-IDs zu ermitteln, die beim Erstellen oder Aktualisieren von Abonnements verwendet werden sollen.

Es werden alle registrierten Ziele für Ihre Organisation abgerufen.

Spezifisches Ziel abrufen

Es werden Details für ein bestimmtes Ziel abgerufen.

Ziel aktualisieren


Es wird eine bestehende Zielkonfiguration aktualisiert.

Ziel löschen


Es wird ein Ziel aus Ihrer Konfiguration gelöscht.


Abonnementverwaltung
Ein Abonnement ordnet einem registrierten Ziel ein oder mehrere Ereignisse zu und legt fest, welche Benachrichtigungen Sie erhalten und wohin diese gesendet werden. Jedes Abonnement bezieht sich auf ein einzelnes Thema, Sie können jedoch mehrere Abonnements erstellen, um alle für Ihren Workflow relevanten Ereignisse abzudecken.

Abonnement erstellen

Es wird ein Abonnement erstellt, um Ereignisse Ihren Zielen zuzuordnen.

Anfragetext:

Antwort:

Alle Abonnements auflisten


Es werden alle Abonnements für Ihre Organisation abgerufen.

Abonnement aktualisieren

Es wird eine bestehende Abonnement-Konfiguration aktualisiert.

Abonnement löschen

Es wird ein Abonnement aus Ihrer Konfiguration gelöscht.


Zieltypen

Zieltypen definieren, wie Prime Video Benachrichtigungen an Ihre Systeme sendet. Sie können zwischen von AWS verwalteten Services für eine zuverlässige und skalierbare Bereitstellung wählen oder einen HTTPS-Webhook konfigurieren, um Benachrichtigungen direkt an Ihrem eigenen Endpunkt zu empfangen.

AWS-Ziele (SQS, SNS, EventBridge)

    Erforderliche Felder:

    • destination – ARN der AWS-Ressource
    • assumeRoleArn – IAM-Rolle für die Bereitstellung
    • externalId – Sicherheits-ID (optional, aber empfohlen)

    SQS-Beispiel:

    SNS-Beispiel:

    EventBridge-Beispiel:

    Bearer-Token:

    API-Schlüssel:

    HMAC (empfohlen):


    Nutzdaten

    Struktur der Nutzdaten
    Alle Benachrichtigungsnutzdaten folgen einer konsistenten Struktur:

    Feld

    Beschreibung

    alid

    Partnerangebots-ID (Titelkennzeichnung)

    Gebiet

    Gebietscode (z. B. USA, GB)

    Marketplace

    Marketplace code

    partnerAlias

    Partner-ID

    eventType

    Das spezifische Ereignis, das eingetreten ist

    callbackUrl

    URL zum Abrufen der vollständigen Statusdetails

    eventTimestamp

    ISO-8601-Zeitstempel des Ereignisses

    Webhooks empfangen HTTP-POST-Anfragen mit folgenden Nutzdaten:

    Authentifizierungs-Header:

    • HMAC: X-Signatur: {signature}X-Signatur: {signature}
    • API-Schlüssel: X-API-Schlüssel: {key}X-API-Schlüssel: {key}
    • Bearer: Bearer-{token}Autorisierung: Bearer {token}

    Antworten auf Fehler

    Wenn eine Anfrage nicht abgeschlossen werden kann, gibt die API eine strukturierte Fehlerantwort zurück, die Ihnen dabei hilft, das Problem zu identifizieren und zu beheben. Die Antwort enthält einen Fehlercode und eine menschenlesbare Meldung, die das Problem beschreibt.

    Häufige Fehlercodes:

    • BAD_REQUEST – Ungültige Anfrageparameter
    • UNAUTHORIZED – Authentifizierung fehlgeschlagen
    • NOT_FOUND – Ressource wurde nicht gefunden
    • CONFLICT – Ressource ist bereits vorhanden

    Anleitung zur Einrichtung von AWS-Ziel

    Wenn Sie einen AWS-Service (SQS, SNS oder EventBridge) als Benachrichtigungsziel verwenden, müssen Sie eine IAM-Bereitstellungsrolle konfigurieren, um Prime Video die Berechtigung zu erteilen, Benachrichtigungen an Ihre AWS-Ressourcen zu senden. Befolgen Sie die folgenden Schritte, um die erforderlichen IAM-Rollen- und Berechtigungsrichtlinien einzurichten, bevor Sie Ihr Ziel registrieren.

    Voraussetzungen

    • AWS-Zielressource (SQS Queue, SNS Topic oder EventBridge Bus)
    • IAM-Bereitstellungsrolle mit Vertrauens- und Berechtigungsrichtlinien

    Einrichtung der IAM-Rolle

    1. Rolle erstellen: AWS-Konsole → IAM → Rollen → Rolle erstellen → Benutzerdefinierte Vertrauensrichtlinien

    2. Vertrauensrichtlinien

    3. Berechtigungsrichtlinien (eine auswählen):

    SQS:


    SNS:

    EventBridge:

    Häufig gestellte Fragen

    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