Ottieni una chiave API

Documentazione di amodb

Parti dall'avvio rapido per fare la prima chiamata in due minuti. Poi leggi come funzionano chiavi, limiti di richieste, errori, lingue e immagini. amodb mantiene i percorsi e il JSON di TMDB v3 e OMDb, quindi la maggior parte delle pagine spiega cosa è uguale, cosa aggiunge amodb e i pochi punti in cui differisce.

Aggiornato il Vedi in Markdown

Prima richiesta
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)

URL di base

UsoURL di baseParametro della chiave
Stile TMDB v3https://api.amodb.dev/3api_key oppure Authorization: Bearer
Stile OMDbhttps://api.amodb.dev/omdb/apikey
Immaginihttps://img.amodb.dev/t/p/{size}/{file}nessuno
Catalogo dei pianihttps://api.amodb.dev/plansnessuno

Inizia da qui

  • Avvio rapido

    Fai la prima chiamata ad amodb: ottieni una chiave, richiedi i dettagli di un film in curl, JavaScript, Python, PHP o Go, carica la locandina. Meno di 2 minuti.

  • Autenticazione

    Come inviare la chiave amodb: api_key nella query, un header Authorization Bearer o apikey per le chiamate OMDb. Formato, conservazione, rotazione, errori 401.

  • Limiti di richieste

    amodb limita ogni chiave per richieste al minuto in una finestra scorrevole di 60 secondi: 20, 40 o 120 in base al piano. Leggi gli header, gestisci il 429.

Concetti

  • Errori

    Ogni errore di amodb con stato HTTP, status_code e messaggio TMDB, più la forma dell'errore OMDb. Cosa significa ciascuno e cosa deve fare il tuo client.

  • Lingue

    amodb serve titoli, trame e nomi in 14 lingue. Passa un tag in stile TMDB come ru-RU o pt-BR in language; qualsiasi altro tag ripiega sull'inglese.

  • Immagini

    Carica locandine, sfondi e foto dei profili da img.amodb.dev con percorsi e dimensioni TMDB da w92 a original. Nessuna chiave, cache di 30 giorni, uno schema.

Risorse

  • Registro delle modifiche

    Elenco datato delle modifiche all'API amodb, all'host immagini img.amodb.dev, ai piani e al sito. Le novità vanno in cima, con cosa è cambiato e cosa devi fare.

  • Stato

    Come sapere se amodb è attivo: l'endpoint di salute pubblico, i codici di errore che indicano un incidente e come segnalare un problema con i dettagli giusti.

Riferimento API

Tutti gli endpoint

Film

Serie TV

Persone

Ricerca e liste

Estensioni amodb

Stile OMDb

Tutorial

Tutti i tutorial

Altre guide e indici

  • Confronta amodb

    Confronti diretti tra amodb e altre API di metadati su film e serie TV: compatibilità, lingue, limiti, immagini e prezzi, con numeri che puoi verificare.

  • Casi d'uso

    Come i team usano amodb per dati su film e serie TV: cataloghi, media server, raccomandazioni, bot e ricerca, con gli endpoint e i limiti di ogni caso.