API Offer Status

• Opérations centralisées : importez les données du catalogue directement dans vos propres systèmes, ainsi que dans vos autres canaux de distribution, sans avoir à vous connecter à Slate pour chaque vérification de statut
• Résolution plus rapide des problèmes : détectez immédiatement les problèmes de disponibilité et comprenez ce qui empêche la mise en ligne de vos titres, réduisant ainsi le délai de résolution de 3 jours
• Gestion proactive du catalogue : surveillez l’intégralité de votre catalogue par programmation sur tous les territoires et types d’offres, vous permettant de faire évoluer vos opérations au fur et à mesure de la croissance de votre activité
• Vérification du lancement en temps réel : sachez instantanément au courant du lancement de votre contenu, sans avoir besoin de vérifier manuellement la page d’accueil ni d’attendre des mises à jour de statut

Cette section fournit les spécifications techniques permettant aux développeurs d’intégrer l’API Offer Status dans leurs systèmes. Utilisez cette référence pour comprendre le format de requête, la structure de réponse et les types de données renvoyés par l’API.

L’API Offer Status utilise une simple structure de récupération via requête GET où tous les paramètres de requête sont transmis via l’URL. Aucun corps de requête n’est requis. Cela facilite l’intégration dans vos systèmes ainsi que les tests à l’aide de clients HTTP ou d’outils de ligne de commande standards. Créez simplement l’URL avec votre identifiant de titre et les filtres optionnels, puis envoyez une requête GET pour récupérer le statut actuel de vos offres :

Paramètres
Ce tableau définit les paramètres que vous pouvez utiliser pour demander des informations sur l’état de vos offres.

Exemples de requêtes

Remarque : Plus les paramètres de votre demande sont spécifiques, plus votre réponse sera ciblée. Si vous omettez des paramètres facultatifs tels que la région du site et le territoire, l’API renverra des informations de statut pour tous les périmètres applicables associés à cet ALID.

Le schéma de réponse définit la structure des données renvoyées par l’API Offer Status. La compréhension de ces types de données vous aidera à analyser la réponse et à intégrer efficacement les informations de statut dans vos systèmes.

Obtenir une réponse de statut
La réponse de premier niveau contenant des informations sur le statut de l’offre pour le titre demandé. Chaque réponse inclut des données de statut filtrées en fonction des paramètres de votre requête, ce qui vous permet de comprendre l’état de disponibilité dans les différents secteurs d’activité et territoires.

Type de statut de l’offre - Structure de données de base représentant le statut d’une offre unique. Cela inclut des informations de statut générales et des données détaillées au niveau des transactions pour chaque fenêtre de disponibilité.

Type d’éditeur
Identifie votre organisation en tant que concédant de licence de contenu. Cette valeur est fournie par Prime Video lors de l’intégration.

Type de statut
Fournit les informations générales sur le statut de l’offre, y compris la plage de dates et le code de progression actuel.

Type de transaction
Représente une fenêtre de disponibilité unique avec ses conditions de licence et son statut associés. Chaque transaction correspond à une combinaison spécifique de type de licence, de territoire et de profil de format.

FeatureStatus type
Fournit des informations de statut détaillées pour une fenêtre de disponibilité spécifique, notamment la plage de dates et le code de progression.

FormatProfile type
Spécifie le niveau de qualité vidéo pour la disponibilité. Plusieurs profils de format peuvent être inclus dans une seule transaction si vous avez rendu votre contenu disponible dans plusieurs niveaux de qualité (par exemple, à la fois en HD et en UHD).

Remarque : Les schémas ci-dessus représentent la structure de réponse actuelle de l’API. Certains champs (tels que Comments, ProgressCode dans FeatureStatus et TransactionID) sont actuellement nuls mais il se peut qu’ils soient renseignés dans de prochaines versions.

Cet exemple illustre une réponse d’API typique pour un titre SVOD avec plusieurs fenêtres de disponibilité sur différents territoires. La réponse montre comment les informations de statut sont structurées, y compris le statut général, les détails des transactions et les profils de format.

Exemple de SVOD :

Les sections suivantes fournissent des réponses aux questions courantes concernant l’utilisation de l’API Offer Status.