Obter chave de API

Documentação do amodb

Comece pelo início rápido para fazer sua primeira chamada em dois minutos. Depois leia como funcionam as chaves, os limites, os erros, os idiomas e as imagens. O amodb mantém os caminhos e o JSON do TMDB v3 e do OMDb, então a maioria das páginas explica o que é igual, o que o amodb acrescenta e onde ele difere.

Atualizado em Ver em Markdown

Primeira requisição
bashjspyphpgo 
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
const data = await res.json();
import os
import requests

res = requests.get(
    "https://api.amodb.dev/3/movie/550",
    params={"language": "en-US"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
data = res.json()
<?php
$ch = curl_init("https://api.amodb.dev/3/movie/550?language=en-US");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("AMODB_KEY")],
]);
$data = json_decode(curl_exec($ch), true);
req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/movie/550?language=en-US", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()

var data map[string]any
json.NewDecoder(res.Body).Decode(&data)

URLs base

UsoURL baseParâmetro da chave
Estilo TMDB v3https://api.amodb.dev/3api_key ou Authorization: Bearer
Estilo OMDbhttps://api.amodb.dev/omdb/apikey
Imagenshttps://img.amodb.dev/t/p/{size}/{file}nenhum
Catálogo de planoshttps://api.amodb.dev/plansnenhum

Comece aqui

  • Início rápido

    Faça sua primeira chamada ao amodb: obtenha uma chave, peça um filme em curl, JavaScript, Python, PHP ou Go e carregue o pôster. Menos de 2 minutos.

  • Autenticação

    Como enviar sua chave do amodb: api_key na consulta, um cabeçalho Authorization Bearer ou apikey nas chamadas OMDb. Formato, armazenamento, rotação e erros 401.

  • Limites de requisições

    O amodb limita cada chave por requisições por minuto em uma janela de 60 segundos: 20, 40 ou 120 por plano. Leia os cabeçalhos e trate o 429 com Retry-After.

Conceitos

  • Erros

    Todos os erros do amodb com status HTTP, status_code e mensagem do TMDB, mais o formato de erro do OMDb. O que cada um significa e o que seu cliente deve fazer.

  • Idiomas

    O amodb serve títulos, sinopses e nomes em 14 idiomas. Passe uma tag no estilo TMDB como ru-RU ou pt-BR em language; qualquer outra tag volta para o inglês.

  • Imagens

    Pôsteres, backdrops e fotos de perfil em img.amodb.dev com caminhos e tamanhos do TMDB, de w92 a original. Sem chave, cache de 30 dias e um só padrão de URL.

Recursos

  • Histórico de alterações

    Lista datada das mudanças na API do amodb, no host de imagens img.amodb.dev, nos planos e no site. As novas vêm primeiro, com o que mudou e o que fazer.

  • Status

    Como saber se o amodb está no ar: o endpoint de saúde público, os erros que indicam um incidente e como relatar um problema com os detalhes necessários.

Referência da API

Todos os endpoints

Filmes

Séries

Pessoas

Busca e listas

Extensões do amodb

Estilo OMDb

Tutoriais

Todos os tutoriais

Mais guias e índices

  • Comparar o amodb

    Comparações lado a lado do amodb com outras APIs de metadados de filmes e séries: compatibilidade, idiomas, limites, imagens e preços, com números verificáveis.

  • Casos de uso

    Como equipes usam o amodb para dados de filmes e séries: catálogos, servidores de mídia, recomendação, bots e pesquisa, com os endpoints e limites de cada caso.