Cómo crear una clave API de TMDB y añadirla a Kodi

Si un complemento de Kodi solicita tus credenciales de TMDB, solicítalas a través de tu cuenta de TMDB e introdúcelas en la configuración del complemento. Kodi no dispone de un campo de clave API de TMDB para todo el sistema, por lo que el complemento debe ser compatible con una clave personalizada. Una clave personal puede ser útil si un complemento utiliza credenciales compartidas, pero no evita las limitaciones de uso de TMDB ni garantiza la solución de los fallos.

Las imágenes de la interfaz que aparecen a continuación son solo ilustrativas. TMDB puede modificar sus controles de cuenta, y los menús de Kodi varían según el tema, el dispositivo y el complemento.

Antes de empezar

Necesitas una cuenta de TMDB y un complemento de Kodi que utilice la API de TMDB y que permita configurar credenciales personalizadas. TMDB recomienda solicitar acceso desde un navegador de escritorio, ya que su proceso de registro de API no está optimizado para dispositivos móviles. La guía de inicio rápido de TMDB explica dónde solicitar acceso y proporciona enlaces a los términos que debes aceptar.

TMDB enumera dos credenciales de aplicación: una clave API (autenticación v3) y un token de acceso de lectura API (autenticación v4) . TMDB documenta ambas como métodos para autenticar las solicitudes de API, pero un complemento específico puede aceptar solo un formato. Asegúrese de que la credencial coincida con el campo que solicita el complemento; no pegue una clave v3 en un campo que solicite específicamente un token de portador v4.

Cómo crear una clave API de TMDB

1. Crea tu cuenta de TMDB o inicia sesión. Visita The Movie Database , regístrate si es necesario y completa la verificación de cuenta que te solicite. Luego, inicia sesión desde un navegador de escritorio.

   

2. Abre la página de configuración de la API. Desde tu cuenta, abre Configuración y selecciona API en el menú de navegación. La documentación actual de TMDB describe el enlace a la API como parte de la configuración de la cuenta; su ubicación o redacción exactas pueden cambiar.

   

3. Inicie una solicitud de aplicación API. Siga las instrucciones de la página de la API o cree un flujo. Elija el tipo de aplicación que mejor se adapte a su uso real, proporcione una descripción precisa del software y de cómo planea utilizar la API, y revise los términos y las directrices de la API antes de aceptarlos. No utilice información de contacto ni de proyecto ficticia.

   

4. Espere a que TMDB emita las credenciales. Una vez aceptada la solicitud, vuelva a la configuración de la API y revise las dos entradas: Clave de API (autenticación v3) y Token de acceso de lectura de la API (autenticación v4). Se trata de credenciales de aplicación independientes. La guía de autenticación de TMDB explica los métodos disponibles.

   

5. Copia las credenciales que solicita tu complemento. Si el campo indica "clave API", copia la clave API (autenticación v3) . Si solicita explícitamente un token de acceso de lectura API o un token de portador, utiliza ese valor v4. No intentes adivinar entre ambos y mantén tus credenciales fuera de publicaciones públicas y capturas de pantalla.

   

Cómo agregar la clave en Kodi

6. Abre el área de complementos de Kodi. Desde la pantalla de inicio, selecciona Complementos y abre el navegador de complementos o los complementos instalados. Los nombres y la disposición pueden variar según la versión y el tema de Kodi.

   

7. Abre la configuración del complemento compatible. Busca el complemento que recupera los metadatos de películas o series de TV de TMDB, selecciónalo, abre el menú contextual de Kodi y elige Configuración. La documentación de complementos de Kodi describe este procedimiento. El control del menú contextual puede tener un nombre diferente en el mando a distancia o en el dispositivo. Confirma que la documentación del complemento admite credenciales TMDB personalizadas.

   

8. Introduzca la clave y guarde. Abra la sección de cuenta, metadatos o API del complemento y localice el campo de clave API de TMDB. Pegue el valor copiado, compruebe que no haya espacios al principio ni al final, y seleccione Aceptar o Guardar. Si el complemento solicita un tipo de credencial diferente, utilice el valor correspondiente de TMDB. Reinicie el complemento solo si su documentación indica que la configuración se aplica tras el reinicio.

   

Si el complemento sigue presentando errores

• Sin campo de clave API: Es posible que el complemento no admita credenciales TMDB personalizadas. Kodi no dispone de una configuración global que pueda sustituir la configuración propia del complemento.
• Error de autenticación: compruebe que el valor se haya copiado por completo y que haya utilizado el tipo de credencial especificado por el complemento. Una clave API y un token de acceso de lectura API son campos diferentes en la configuración de la cuenta de TMDB.
• Límite de solicitudes o error de conexión: Una clave personal no exime a las solicitudes de los límites de TMDB. Es posible que el complemento siga realizando demasiadas solicitudes o que TMDB no esté disponible temporalmente; revise el registro del complemento y el estado del servicio de TMDB antes de modificar más ajustes.
• Las categorías siguen fallando: una clave no puede reparar el código de complementos no relacionados, una integración de metadatos obsoleta o una dependencia rota. Actualice solo desde una fuente confiable y siga la documentación actual del complemento. Las guías antiguas pueden mencionar Covenant o Elysium, pero estos complementos tienen su propia configuración e historial de versiones; sus rutas de menú no se aplican a todos los complementos de Kodi.

Para el uso no comercial de la API, las preguntas frecuentes de la API de TMDB indican que los datos e imágenes deben ser atribuidos. Los proyectos comerciales deben contactar a TMDB para obtener información sobre licencias. Si solo está configurando un complemento existente, siga las instrucciones del responsable del complemento y no publique sus credenciales personales.