Portal do Desenvolvedor • REST API v1

Documentação da API

Integre dados de catálogo, acompanhamento de episódios, estatísticas e recursos sociais diretamente nos seus aplicativos e automações.

Base URL:

http://localhost/api/v1

Autenticação por Bearer Token (Sanctum)

Para acessar endpoints protegidos de marcação e estatísticas pessoais, inclua o token de autenticação no cabeçalho Authorization:

Authorization: Bearer 1|TVCheckSecretAccessTokenHere...

Endpoints Disponíveis

GET/catalog/search

Público

Pesquisa unificada por títulos no catálogo indexado com cache Redis de alta velocidade.

Parâmetros de Requisição:

q(string)Obrigatório

Termo de busca (ex: 'Breaking Bad', 'Inception')

type(string)

'movie', 'tv' ou omitido para todos

page(integer)

Número da página (padrão: 1)

curl -X GET "http://localhost/api/v1/catalog/search?q=Inception&type=movie" \
  -H "Accept: application/json"

Exemplo de Resposta (200 OK)application/json

{
  "success": true,
  "data": {
    "items": [
      {
        "id": 27205,
        "title": "A Origem",
        "original_title": "Inception",
        "media_type": "movie",
        "release_date": "2010-07-15",
        "vote_average": 8.4,
        "poster_url": "https://image.tmdb.org/t/p/w500/9gk7adHYeDvHkCSEqAvQNLV5Uge.jpg"
      }
    ],
    "total_results": 1
  }
}