Como criar uma chave de API do TMDB e adicioná-la ao Kodi

Se um complemento do Kodi solicitar suas credenciais do TMDB, solicite uma através da sua conta do TMDB e insira-a nas configurações do complemento. O Kodi em si não possui um campo de chave de API do TMDB para todo o sistema, portanto, o complemento precisa suportar uma chave personalizada. Uma chave pessoal pode ajudar se um complemento depender de uma credencial compartilhada, mas não ignora os limites de taxa do TMDB nem garante a correção de falhas.

As imagens da interface abaixo são ilustrativas. O TMDB pode alterar seus controles de conta, e os menus do Kodi variam de acordo com o tema, o dispositivo e o complemento.

Antes de começar

Você precisa de uma conta TMDB e um complemento para Kodi que utilize a API do TMDB e exponha uma configuração para credenciais personalizadas. O TMDB recomenda que a solicitação seja feita por meio de um navegador em um computador, pois o processo de registro da API não é otimizado para dispositivos móveis. O guia de primeiros passos do TMDB explica onde solicitar acesso e inclui links para os termos que você deve aceitar.

O TMDB lista duas credenciais de aplicação: uma chave de API (autenticação v3) e um token de acesso de leitura de API (autenticação v4) . O TMDB documenta ambas como formas de autenticar solicitações de API, mas um determinado complemento pode aceitar apenas um formato. Certifique-se de que a credencial corresponda ao campo que o complemento solicita; não cole uma chave v3 em um campo que exige especificamente um token de portador v4.

Como criar uma chave de API do TMDB

1. Crie ou faça login na sua conta do TMDB. Visite o The Movie Database , registre-se se necessário e conclua qualquer verificação de conta solicitada. Em seguida, faça login usando um navegador de computador.

   

2. Abra a página de configurações da API. Na sua conta, abra Configurações e selecione API na navegação da conta. A documentação atual do TMDB descreve o link da API como parte das configurações da conta; sua localização ou redação exatas podem mudar.

   

3. Inicie uma solicitação de aplicação à API. Siga as instruções da página da API ou crie um fluxo. Escolha o tipo de aplicação que melhor se adequa ao seu uso real, insira uma descrição precisa do software e de como você planeja usar a API e revise os termos e diretrizes da API antes de aceitá-los. Não utilize informações de contato ou de projeto inventadas.

   

4. Aguarde até que o TMDB emita as credenciais. Assim que a solicitação for aceita, retorne às configurações da API e revise as duas entradas: Chave da API (autenticação v3) e Token de Acesso de Leitura da API (autenticação v4). São credenciais de aplicativo separadas. O guia de autenticação do TMDB explica os métodos disponíveis.

   

5. Copie as credenciais solicitadas pelo seu complemento. Se o campo indicar "Chave de API", copie a Chave de API (autenticação v3) . Se for solicitado explicitamente um Token de Acesso de Leitura da API ou um token de portador, use o valor v4 correspondente. Não tente adivinhar qual dos dois é o correto e mantenha suas credenciais longe de publicações públicas e capturas de tela.

   

Como adicionar a chave no Kodi

6. Abra a área de complementos do Kodi. Na tela inicial, selecione Complementos e abra o navegador de complementos ou os complementos instalados. Os nomes e o layout podem variar entre as versões e temas do Kodi.

   

7. Abra as configurações do complemento compatível. Encontre o complemento que recupera metadados de filmes ou séries do TMDB, selecione-o, abra o menu de contexto do Kodi e escolha "Configurações". A documentação de complementos do Kodi descreve esse procedimento. O controle do menu de contexto pode ter um nome diferente no controle remoto ou no dispositivo. Confirme se a documentação do próprio complemento oferece suporte a credenciais personalizadas do TMDB.

   

8. Insira a chave e salve. Abra a seção de conta, metadados ou API do complemento e localize o campo da chave de API do TMDB. Cole o valor copiado, verifique se não foram adicionados espaços no início ou no final e selecione OK ou Salvar. Se o complemento solicitar um tipo de credencial diferente, use o valor correspondente do TMDB. Reinicie o complemento somente se a documentação indicar que as configurações entram em vigor após a reinicialização.

   

Se o complemento ainda apresentar erros

• Campo de chave de API ausente: o complemento pode não suportar credenciais TMDB personalizadas. O Kodi não possui uma configuração global que possa substituir a configuração do próprio complemento.
• Erro de autenticação: verifique se o valor foi copiado completamente e se você usou o tipo de credencial especificado pelo complemento. Uma chave de API e um token de acesso de leitura da API são campos diferentes nas configurações da conta do TMDB.
• Erro de limite de taxa ou de conexão: Uma chave pessoal não isenta as solicitações dos limites do TMDB. O complemento pode ainda estar fazendo muitas solicitações ou o TMDB pode estar temporariamente indisponível; verifique o registro do complemento e o status do serviço do TMDB antes de alterar mais configurações.
• As categorias ainda apresentam problemas: uma chave não consegue reparar código de complementos não relacionados, uma integração de metadados desatualizada ou uma dependência quebrada. Atualize apenas a partir de uma fonte confiável e siga a documentação atual do complemento. Guias mais antigos podem mencionar Covenant ou Elysium, mas esses complementos têm suas próprias configurações e histórico de versões; seus caminhos de menu não se aplicam a todos os complementos do Kodi.

Para uso não comercial da API, as perguntas frequentes da API do TMDB informam que os dados e imagens devem ser devidamente atribuídos. Projetos comerciais devem entrar em contato com o TMDB para obter informações sobre licenciamento. Se você estiver apenas configurando um complemento existente, siga as instruções do responsável pelo complemento e não publique suas credenciais pessoais.