API TheTVDB API v3

Consulte TheTVDB API v3, do provedor thetvdb.com, versão 3.0.0: documentação, especificação OpenAPI 2.0 e referências para planejar a integração.

thetvdb.com · Versão 3.0.0

Conheça a plataforma

O que integrar com TheTVDB API v3

Descrição técnica preservada da especificação de origem. A versão do contrato ajuda a identificar a API; confirme a disponibilidade atual no fornecedor.

API v3 targets v2 functionality with a few minor additions. The API is accessible via https://api.thetvdb.com and provides the following REST endpoints in JSON format. How to use this API documentation ---------------- You may browse the API routes without authentication, but if you wish to send requests to the API and see response data, then you must authenticate. 1. Obtain a JWT token by POSTing to the /login route in the Authentication section with your API key and credentials. 1. Paste the JWT token from the response into the "JWT Token" field at the top of the page and click the 'Add Token' button. You will now be able to use the remaining routes to send requests to the API and get a response. Language Selection ---------------- Language selection is done via the Accept-Language header. At the moment, you may only pass one language abbreviation in the header at a time. Valid language abbreviations can be found at the /languages route.. Authentication ---------------- Authentication to use the API is similar to the How-to section above. Users must POST to the /login route with their API key and credentials in the following format in order to obtain a JWT token. {"apikey":"APIKEY","username":"USERNAME","userkey":"USERKEY"} Note that the username and key are ONLY required for the /user routes. The user's key is labled Account Identifier in the account section of the main site. The token is then used in all subsequent requests by providing it in the Authorization header. The header will look like: Authorization: Bearer . Currently, the token expires after 24 hours. You can GET the /refresh_token route to extend that expiration date. Versioning ---------------- You may request a different version of the API by including an Accept header in your request with the following format: Accept:application/vnd.thetvdb.v$VERSION. This documentation automatically uses the version seen at the top and bottom of the page.

Mídia e ConteúdoAuthenticationEpisodesSeriesSearchUpdatesUsersLanguagesmediaopen_data

Ficha técnica

Como funciona a integração

Versões, permissões, preços e limites podem mudar. Consulte a documentação da plataforma antes de implementar.

Do planejamento à produção

Checklist para integrar TheTVDB API v3

  1. Defina o fluxo. Identifique quais dados precisam circular, o sistema de origem e o resultado esperado.
  2. Leia os requisitos oficiais. Verifique acesso à API, plano necessário, versão e ambiente de testes.
  3. Configure o acesso com segurança. Guarde credenciais secretas no servidor e conceda apenas as permissões necessárias. Restrinja chaves públicas conforme a documentação do fornecedor.
  4. Teste a primeira requisição. Valide os campos, a paginação e o formato de resposta com dados de teste.
  5. Prepare o tratamento de falhas. Considere limites de requisição, retentativas com espera e prevenção de operações duplicadas.
  6. Acompanhe a integração. Registre erros sem expor dados sensíveis e monitore alterações na API.