API Offer Status

• Operazioni centralizzate: estrai i dati del catalogo direttamente nei tuoi sistemi insieme agli altri canali di distribuzione, senza bisogno di accedere a Slate per ogni controllo dello stato
• Risoluzione più rapida dei problemi: rileva immediatamente i problemi di disponibilità e scopri cosa impedisce la pubblicazione dei tuoi titoli, riducendo i tempi di risoluzione fino a 3 giorni
• Gestione proattiva del catalogo: monitora l’intero catalogo in modo programmatico su tutti i territori e i tipi di offerta, consentendoti di scalare le operazioni man mano che la tua azienda cresce
• Verifica del lancio in tempo reale: scopri immediatamente quando i tuoi contenuti vengono lanciati con successo senza controlli manuali sulla vetrina o attese di aggiornamenti di stato

Questa sezione fornisce le specifiche tecniche per consentire agli sviluppatori di integrare l’API Offer Status nei loro sistemi. Usa questo riferimento per comprendere il formato della richiesta, la struttura della risposta e i tipi di dati restituiti dall’API.

L’API Offer Status utilizza una semplice struttura di recupero tramite GET in cui tutti i parametri della query vengono passati attraverso l’URL: non è richiesto alcun corpo della richiesta. Ciò semplifica l’integrazione nei sistemi e il test utilizzando client HTTP standard o strumenti da riga di comando. Basta creare l’URL con l’identificatore del titolo e i filtri opzionali, quindi inviare una richiesta GET per recuperare lo stato attuale delle tue offerte:

Parametri
Questa tabella definisce i parametri che è possibile utilizzare per interrogare le informazioni sullo stato dell’offerta.

Richieste di esempio

Nota: Più specifici sono i parametri della tua richiesta, più mirata sarà la tua risposta. Se ometti parametri opzionali come marketplace e territorio, l’API restituirà informazioni sullo stato per tutti gli ambiti applicabili associati a quell’ALID.

Lo schema di risposta definisce la struttura dei dati restituiti dall’API Offer Status. La comprensione di questi tipi di dati ti aiuterà ad analizzare la risposta e a integrare efficacemente le informazioni sullo stato nei tuoi sistemi.

Ottieni risposta sullo stato
La risposta di primo livello contenente le informazioni sullo stato dell’offerta per il titolo richiesto. Ogni risposta include dati sullo stato filtrati in base ai parametri della richiesta, che consentono di comprendere lo stato di disponibilità in diverse linee di business e territori.

Tipo di stato dell’offerta. La struttura dei dati di base che rappresenta lo stato di una singola offerta. Ciò include informazioni generali sullo stato e dati dettagliati a livello di transazione per ogni finestra di disponibilità.

Tipo di Publisher
Identifica la tua organizzazione come licenziante dei contenuti. Questo valore viene fornito da Prime Video durante l’onboarding.

Tipo di stato
Fornisce le informazioni generali sullo stato dell’offerta, incluso l’intervallo di date e il codice di avanzamento corrente.

Tipo di transazione
Rappresenta una singola finestra di disponibilità con i termini e lo stato di licenza associati. Ogni transazione corrisponde a una specifica combinazione di tipo di licenza, territorio e profilo di formato.

FeatureStatus type
Fornisce informazioni dettagliate sullo stato per una finestra di disponibilità specifica, tra cui l’intervallo di date e il codice di avanzamento.

Tipo FormatProfile
Specifica il livello di qualità video per la disponibilità. È possibile includere più profili di formato in un’unica transazione se hai utilizzato i tuoi contenuti in più livelli di qualità (ad esempio, sia HD che UHD).

Nota: Gli schemi sopra riportati rappresentano l’attuale struttura di risposta dell’API. Alcuni campi (come Comments, ProgressCode in FeatureStatus e TransactionID) sono attualmente nulli ma potrebbero essere compilati nelle versioni future.

Questo esempio dimostra una tipica risposta API per un titolo SVOD con più finestre di disponibilità in diversi territori. La risposta mostra come sono strutturate le informazioni sullo stato, inclusi lo stato generale, i dettagli delle transazioni e i profili di formato.

Esempio SVOD:

Le seguenti sezioni forniscono risposte alle domande più frequenti sull’utilizzo dell’API Offer Status.