Video Central

Incorporación a la suite de API de contenido

El Content API Suite te permite automatizar los flujos de trabajo de administración de contenido y recibir visibilidad en tiempo real del estado de tu contenido en Prime Video. Esta suite incluye:

API Avails: Enviar, actualizar, recuperar y eliminar los derechos de contenido (disponibles) mediante programación en todas las líneas de negocio y territorios
API de estado de la oferta: comprueba si tus títulos están disponibles en la tienda Prime Video y descubre qué es lo que impide que se publiquen
API de estado de activos: supervise el estado de entrega de los activos y reciba comentarios instantáneos sobre la preparación del contenido

Cuando se incorpore a Content API Suite, recibirá acceso a las API que solicite durante el proceso de incorporación. Todas las API de este paquete utilizan la autenticación basada en certificados MTLS (Mutual Transport Layer Security) con claves de API.

Paso 1: Solicita acceso y genera las credenciales

Comunícate con tu contacto de Prime Video o presenta una solicitud de acceso a través de Contáctanos para solicitar el acceso a la suite de API de contenido.

Paso 2: Genera las credenciales y envíalas

Una vez que se apruebe tu solicitud de acceso, genera una clave privada y una solicitud de firma de certificado (CSR) para cada entorno y compártelas con tu contacto de Prime Video designado.

Genera tu CSR
Puedes usar cualquier herramienta de certificación para generar tus CSR. Si deseas utilizar OpenSSL, puede poner en marcha los dos comandos siguientes:

Envía tu CSR a tu contacto de Prime Video
La CSR contiene toda la información que necesitamos para generar tu certificado de API. Este es el archivo que enviarás a tu contacto como parte de tu solicitud de incorporación. Una vez que Prime Video reciba tu CSR, no volverás a necesitar este archivo.

Nota: Es muy importante que protejas tus archivos de claves privadas y que nunca los compartas con nadie, ni siquiera con Prime Video. Nunca te pediremos este archivo. Lo usarás más adelante, cuando nos hagas tus llamadas a la API.

Paso 3: Recibe tus credenciales

Cuando se apruebe tu solicitud, recibirás un correo electrónico del equipo de Prime Video con la siguiente información:

El certificado público que utilizarás para llamarnos.
Tu clave de API para los encabezados de solicitud
Los puntos de conexión (endpoints) de URL para las llamadas a la API.
Información sobre el TPS que tienes configurado con tu certificado.

Paso 4: Configura tu integración

¡Felicidades! Ahora puedes usar tu clave privada, certificado público y clave de API para llamar a la API. A continuación, se muestran ejemplos de integraciones que usan diferentes tecnologías:

Bash

Python

Node.js

Paso 5: Pon a prueba tu integración

Para la API de Avails, ofrecemos soporte de pruebas para garantizar que puedas enviar, actualizar y dar de baja correctamente las versiones disponibles a través de la API. Dado que estas operaciones afectan directamente a los activos (no solo a la recuperación de datos), recomendamos encarecidamente a todos los socios que prueben minuciosamente su integración. En el caso de las API de estado de la oferta y estado de los activos, dado que son de solo lectura, puedes realizar pruebas con la cuenta de producción.

Paso 6: Comienza a usar la API

¡Felicidades! La prueba está completa y validada. Ahora puedes empezar a usar el entorno de producción con tus credenciales de producción para administrar tu contenido en Prime Video. Tu integración está lista para optimizar tus operaciones de contenido y ofrecer visibilidad en tiempo real de tu catálogo.

Preguntas frecuentes sobre las API de contenido

El plazo de incorporación varía en función de su preparación técnica y de la complejidad de la integración. Por lo general, el proceso incluye el aprovisionamiento de credenciales, la revisión de la documentación técnica, el desarrollo de la integración y las pruebas. Recomendamos que el equipo de desarrollo dedique el tiempo suficiente para crear y probar la integración antes de ponerla en marcha.

Si has recibido tus credenciales de API pero necesitas orientación sobre la implementación, ponte en contacto con tu contacto de Prime Video o contacta con nosotros para hablar sobre tus necesidades y circunstancias individuales. Podemos proporcionarte orientación personalizada sobre:

Cómo autenticarse con sus credenciales
Qué APIs son más relevantes para su empresa
Prácticas recomendadas para la integración y las pruebas
Documentación técnica y ejemplos de código

Incorporación a la suite de API de Analytics

El paquete de API de Analytics le permite integrar varios puntos finales para los datos de rendimiento de Prime Video directamente en sus propios sistemas y obtener información más detallada sobre el rendimiento del contenido. Esta suite incluye:

Conjunto de datos de rendimiento: acceda a datos a nivel de eventos para realizar análisis detallados e integrarlos con sus conjuntos de datos internos
Informes: recupere archivos CSV estáticos con contenido, datos de rendimiento y ganancias de forma periódica
Estado financiero: acceda a los estados de resultados actualizados que reflejen los datos de su panel financiero en Slate
Registro de eventos de suscripción: acceda a los datos de suscripción a nivel de evento para hacer un seguimiento del recorrido de los clientes

Todos los puntos finales de la API de esta suite utilizan la autenticación OAuth 2.0 y proporcionan acceso de solo lectura a los datos de rendimiento. A diferencia de otros informes de Slate, los conjuntos de datos de la API de Analytics solo se adjuntan (cada archivo contiene datos nuevos) y se crean de forma explícita para que los ingenieros asociados consuman datos granulares y realicen análisis.

Paso 1: Crea tu perfil de seguridad

Como parte de este paso, configurarás las credenciales de la aplicación y la configuración de autenticación por medio de la consola para desarrolladores de Amazon.

Registra tu solicitud

Navega hasta la Consola para desarrolladores de Amazon para iniciar el proceso de registro
Inicia sesión con tu cuenta de desarrollador de Amazon existente o crea una nueva si no tienes una
Haz clic en Crear un nuevo perfil de seguridad para empezar a configurar los ajustes de autenticación de la aplicación

Configura tu perfil

Nombre del perfil de seguridad: Elige un nombre descriptivo que identifique claramente tu integración (por ejemplo, “Integración de datos de rendimiento” o “Acceso a la API de Analytics”)
Descripción: Proporciona una explicación clara del propósito de tu aplicación y de cómo utilizarás las API de Analytics
URL del Aviso de privacidad: Incluye una URL que explique a los usuarios cómo tu aplicación gestionará y protegerá sus datos
Haz clic en Guardar para crear tu perfil de seguridad
Deberás recibir un mensaje de éxito una vez que lo hayas configurado de manera correcta

Establece la URL de redireccionamiento

Ve a tu perfil y selecciona las pestañas de Perfil de seguridad para Gestionar en tu perfil de seguridad recién creado:
A continuación, selecciona Configuración web para configurar el comportamiento de redireccionamiento de la aplicación
Agrega tu URL de redireccionamiento: este es el punto de conexión (endpoint) seguro al cual se redirigirá los usuarios después de autorizar tu aplicación (debes usar https:// o https://localhost para el desarrollo local)

Importante: Guarda esta URL de forma segura: tendrás que usar esta URL exacta en el siguiente paso cuando generes tu código de autorización.

Recibe tus credenciales

Navega a la pestaña Configuración web para acceder a las credenciales de tu aplicación
Copia tu identificador de cliente (sirve como identificador único de tu aplicación) y tu secreto de cliente (actúa como la contraseña de tu aplicación)
Almacena ambas credenciales de forma segura en el sistema de gestión de secretos de tu organización; estas se usarán para autenticar todas tus solicitudes de API

Paso 2: Autoriza tu solicitud

Como parte de este paso, autorizarás a tu aplicación a acceder a Prime Video Slate en nombre de tu organización y establecerás los permisos necesarios para recuperar los datos de rendimiento y los análisis a través de las API.

Agrega tu aplicación a Slate

Inicia sesión en tu cuenta de Prime Video Slate con las credenciales de tu organización
Ve a Configuración de la cuenta en la esquina superior derecha y, a continuación, selecciona Aplicaciones en el menú desplegable

Haz clic en Agregar aplicación para iniciar el proceso de autorización

Ingresa tu identificador de cliente (del paso 1) en el campo correspondiente
Selecciona la casilla Informes para conceder a tu aplicación el acceso a los datos e informes de rendimiento
Haz clic en Agregar solicitud para completar el registro en Slate

Genera tu código de autorización

Crea tu URL de autorización al sustituir los marcadores de posición entre corchetes por tus credenciales actuales del paso 1:

Abre esta URL en tu navegador web para iniciar el flujo de autorización
Inicia sesión con las credenciales de tu cuenta de Slate cuando se te pida
Revisa los permisos que solicita tu aplicación y, a continuación, haz clic en Permitir para conceder el acceso
Una vez autorizada, se te redirigirá a la URL de redireccionamiento especificada. Copia el código de autorización de la cadena de consulta de la URL (aparecerá como

Prácticas recomendadas: Recomendamos crear una cuenta de Slate dedicada (por ejemplo, api_access@yourcompany.com) con los permisos mínimos necesarios específicamente para el acceso a la API. Este enfoque mejora la seguridad y facilita la administración y la auditoría del uso de las API en toda la organización.

Nota: Si elimina los permisos del usuario que autoriza para usar informes, entonces también se revocarán los permisos de la aplicación para usar informes.

Paso 3: Solicita tus token de acceso

Como parte de este paso, usarás tu código de autorización para obtener los token necesarios para realizar llamadas autenticadas a la API. El token de acceso permite a tu aplicación recuperar datos de rendimiento, mientras que el token de actualización te permite generar nuevos token de acceso sin repetir el proceso de autorización.

Los códigos de autorización son token de un solo uso. Cuando se usan para recuperar un access_token, devuelven un refresh_token que se puede usar para recuperar el siguiente access_token. La siguiente sección te guía por la recuperación de tu primer refresh_token.

Solicitud inicial de token (solo la primera vez):
Para solicitar un token:

Ingresa el client_id, client_secret, authorization_code, y el grant_type como datos de formulario con codificación URL.
Haz una solicitud HTTP.
El comando curl para generar token desde el authorization_code se muestra en el siguiente ejemplo.

Actualización de tu token de acceso:
Para todas las sesiones posteriores a tu solicitud inicial de token, usa tu token de actualización para obtener nuevos token de acceso:

Paso 4: Configura tu aplicación

¡Felicidades! Ahora tiene todas las credenciales necesarias para llamar a las API de rendimiento. Como parte de este paso, configurarás tu aplicación para incluir tu token de acceso en el encabezado de autorización de cada solicitud de API, lo que te permitirá recuperar los datos de suscripción, las métricas de rendimiento y los análisis de tu contenido.

Ejemplo de solicitud de API:

En este ejemplo se muestra cómo autenticar tus solicitudes: reemplaza con el token de acceso actual que recibiste en el paso 3. Ahora puedes usar este patrón de autenticación para acceder a todos los puntos de conexión (endpoints) disponibles de la API de rendimiento y recuperar los archivos de conjunto de datos de solo adición y que contienen datos granulares para tus flujos de análisis.

Paso 5: Integración de pruebas

Recomendamos encarecidamente a todos los socios que prueben minuciosamente su integración para garantizar un acceso fiable a los datos de rendimiento. Como parte de este paso, validarás que tu flujo de autenticación funciona correctamente, que tus llamadas a la API devuelven los datos esperados y que la gestión de errores está configurada de manera correcta.

Verifica la autenticación: confirma que tu token de acceso autentica correctamente las solicitudes de API realizando una simple llamada de prueba al punto final de la cuenta
Prueba de recuperación de datos: comprueba que puedes recuperar correctamente los datos de rendimiento y que el formato de respuesta coincide con tus expectativas
Implemente la gestión de errores: diseñe una gestión de errores sólida para situaciones comunes, como los tokens caducados, la limitación de la velocidad y los problemas de red
Valide la lógica de actualización de los tokens: pruebe la implementación de su token de actualización para asegurarse de que su aplicación pueda obtener automáticamente nuevos tokens de acceso sin intervención manual
Confirme la gestión de la caducidad de los tokens: compruebe que su integración detecta correctamente cuándo caducan los tokens de acceso (después de 1 hora) y los actualiza automáticamente antes de realizar llamadas posteriores a la API

Paso 6: Comienza a usarlo

Una vez que completes las pruebas y que valides que la integración funciona de forma confiable, puedes empezar a usar el entorno de producción para recuperar los datos de rendimiento y el análisis en tiempo real para tu contenido en Prime Video. Tus flujos de datos ahora pueden consumir los archivos de conjuntos de datos de solo adición para realizar los análisis granulares que necesita tu organización.

Puedes obtener más información sobre los marcos de datos de la API de Analytics disponibles aquí:

Preguntas frecuentes sobre las API de Analytics

Si las credenciales de su aplicación se han visto comprometidas (por ejemplo, si se enviaron accidentalmente a un repositorio de código público):

Ve a la consola Iniciar sesión con Amazon
Busque su perfil de seguridad, haga clic en Administrar y, a continuación, seleccione Perfil de seguridad
Haga clic en Eliminar perfil de seguridad y escriba «eliminar» en el cuadro de confirmación para continuar

Importante: Al eliminar su perfil de seguridad, se invalidan inmediatamente todos los tokens de acceso y de actualización existentes para todos los usuarios, y se impide el uso futuro de esas credenciales. Deberás crear un nuevo perfil de seguridad y repetir todo el proceso de incorporación si quieres restablecer el acceso a la API.

Guarde su secreto de cliente y su token de actualización en el sistema seguro de administración de secretos de su organización. Nunca codifique estos valores en el código de su aplicación o en los archivos de configuración. Estas credenciales proporcionan acceso a la integración de la API de rendimiento y deben tratarse con los mismos estándares de seguridad que las contraseñas o las claves de API.

Los tokens de acceso caducan después de 1 hora. Implemente una lógica de actualización automática de los tokens en su aplicación para garantizar un acceso ininterrumpido a la API. Tu aplicación debe detectar cuándo los tokens están a punto de caducar o han caducado y, a continuación, utilizar el token de actualización para obtener un nuevo token de acceso antes de realizar llamadas posteriores a la API.

Implemente el registro y la supervisión para realizar un seguimiento de los patrones de uso de las API, incluidos los volúmenes de solicitudes, las tasas de error y los intentos de autenticación. Configura alertas para detectar actividades inusuales que puedan indicar que las credenciales están comprometidas, como solicitudes desde direcciones IP inesperadas, patrones de solicitudes inusuales o errores de autenticación repetidos.

Incorporación de API