Intégration à l’API Avains

Pour accéder à l’API Avails, vous aurez besoin d’un certificat MTLS et d’une clé d’API. Cette section décrit les étapes à suivre pour générer une demande de signature de certificat (CSR), demander un certificat MTLS et envoyer des demandes d’API à l’API Avails.

Étape 1 : Le client crée sa clé privée et sa demande de signature de certificat (CSR) à l’aide d’openssl.

Étape 2 : Le client envoie un e-mail à pv-partner-apis-support@amazon.com avec le fichier client.csr en pièce jointe. (L’équipe vous répondra avec un certificat dans un délai d’un jour ouvrable.) L’extrait de code suivant est un exemple suggéré.

Étape 3 : Le client reçoit un certificat public, un cacert et une clé d’API de la part de l’équipe Partner API. L’extrait de code suivant fournit un exemple des messages que vous pourriez recevoir.

Étape 4 : Le client utilise la clé publique, le certificat public du partenaire et la clé API pour appeler l’API.
Voici quelques exemples d’intégrations utilisant différentes technologies.

Il peut arriver qu’un certificat MTLS doive être révoqué. Si vous souhaitez que l’un de leurs certificats soit révoqué, envoyez les informations présentées dans l’exemple suivant par e-mail à pv-partner-apis-support@amazon.com.

Nous utilisons le schéma MDDF Avail en JSON. Un schéma du schéma est disponible auprès de MovieLabs au lien suivant : https://www.movielabs.com/md/avails/v2.6/avails-v2.6.1/avails-v2.6.1.html#Link2. Le tableau suivant montre le mappage depuis l’EMA pour les propriétés et les attributs MDDF Avail pris en charge.

Les sections suivantes décrivent les différentes méthodes de demande d’API que vous pouvez utiliser avec l’API Renseignements utiles, y compris leurs points de terminaison spécifiques, ainsi que le corps de chaque demande et de chaque réponse.

Catégorie : Extrait complet

OBTENIR :

• Point de terminaison :
  /avails/ {licensor} /full-extract/ {ALID} ? territory= {territoire} &BusinessLine= {BusinessLine}
• Organisme de la demande : -
• ResponseBody : profitez de transactions pour un seul scope

METTEZ :

• Point de terminaison :
  /avails/ {licensor} /full-extract/ {ALID}
• Organisme de la demande : {...
  Données disponibles}
• ResponseBody : réponse en cas de succès/d’échec

SUPPRIMER :

• Point de terminaison :
  /avails/ {licensor} /full-extract/ {ALID} ? territory= {territoire} &BusinessLine= {BusinessLine} &ContractID= {CPH | FIXED_FEE} &ChannelIdentity= {ChannelIdentity}
• Organisme de la demande : -
• ResponseBody : réponse en cas de succès/d’échec

PUBLICATION :

• Point de terminaison :
  /avails/ {licensor} /full-extract/ {ALID} /validate
• Organisme de la demande : {...
  Données disponibles}
• ResponseBody : réponse en cas de succès/d’échec

Catégorie : Batch
Sous-catégorie : Extrait complet

POST :

• Point de terminaison :
  /avails/full-extract/batch/get
• Organisme de la demande :
  
• Organisme d’intervention :

PUBLICATION :

• Point de terminaison :
  /avails/full-extract/batch/put
• Organisme de la demande :
• Organisme d’intervention :

PUBLICATION :

• Point de terminaison :
  /avails/full-extract/batch/delete
• Organisme de la demande :
• Organisme d’intervention :

PUBLICATION :

• Point de terminaison :
  /avails/full-extract/batch/validate
• Organisme de la demande :
• Organisme d’intervention :

Pour Full Extract, tous les Renseignements utiles pour un secteur d’activité ou un territoire doivent être livrés en même temps. Les secteurs d’activité suivants sont pris en charge :

• PRIME_SUBSCRIPTION
• TVOD
• FVOD
• CHAÎNES
  

Les valeurs BusinessLine peuvent être déterminées par la combinaison de LicenseType et BenefitID, comme indiqué dans le tableau suivant.