Obtenir une clé compatible TMDB en quatre étapes

amodb vend des clés pour sa propre API, qui garde les chemins et le JSON de TMDB v3. Ce n'est pas une clé TMDB et elle ne fonctionne pas sur api.themoviedb.org. Vous obtenez une clé de même forme, 32 caractères hexadécimaux en minuscules, que votre client TMDB accepte après un seul changement d'URL de base.

  1. Ouvrez les tarifs et choisissez une offre : 20, 40 ou 120 requêtes par minute. Chaque offre renvoie toutes les données.
  2. Connectez-vous avec votre e-mail. amodb envoie un code à 6 chiffres valable 10 minutes. Il n'y a pas de mot de passe.
  3. Payez par carte, Apple Pay ou Google Pay pour 1 à 24 mois. Rien ne se renouvelle automatiquement.
  4. Ouvrez Compte, puis Clés d'API, et créez une clé. Copiez-la tout de suite, car la clé complète n'est affichée qu'une fois.

Ces étapes prennent environ une minute, et la clé fonctionne dès que le paiement est confirmé.

Utiliser la clé : changer l'URL de base

Gardez votre code TMDB et changez deux valeurs : l'URL de base et la clé. Les deux façons d'envoyer la clé fonctionnent, api_key dans la requête et un en-tête Authorization: Bearer.

Shell 
# TMDB
curl "https://api.themoviedb.org/3/movie/550?api_key=$TMDB_KEY"

# amodb
curl "https://api.amodb.dev/3/movie/550?api_key=$AMODB_KEY"

Le même appel avec un en-tête Bearer, dans trois langages :

bashjspy 
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}` },
});
if (!res.ok) throw new Error(`amodb ${res.status}`);
const movie = await res.json();
console.log(movie.title, movie.release_date);
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,
)
res.raise_for_status()
movie = res.json()
print(movie["title"], movie["release_date"])

La réponse a la forme de TMDB v3 :

JSON 
{
  "id": 550,
  "imdb_id": "tt0137523",
  "title": "Fight Club",
  "release_date": "1999-10-15",
  "runtime": 139,
  "genres": [{ "id": 18, "name": "Drama" }],
  "vote_average": 8.4,
  "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
}

Lisez images.secure_base_url dans /3/configuration pour que les liens des affiches pointent vers img.amodb.dev. Les images n'exigent aucune clé. Pour en savoir plus sur l'envoi de la clé, voir authentification ; un tutoriel plus long se trouve dans le démarrage rapide.

Une clé TMDB gratuite et une clé amodb côte à côte

Le bon choix dépend de votre projet et de vos conditions, pas d'une liste de fonctionnalités. La colonne TMDB reprend seulement ce que TMDB publie en général. Lisez les conditions et la documentation de TMDB pour connaître les règles actuelles.

Clé TMDB gratuiteClé amodb
PrixGratuite pour un usage admissible selon les conditions de TMDBPayante, prépayée pour 1 à 24 mois, sans essai
Comment l'obtenirUn compte TMDB et une demande de clé sur le site de TMDBE-mail, code à 6 chiffres, paiement, puis création de la clé dans votre compte
Usage commercialVoir les conditions de TMDB sur l'usage commercial et l'attributionAutorisé par les conditions d'amodb
Limite de débitFixée par TMDB, voir leur documentation20, 40 ou 120 requêtes par minute selon l'offre
DonnéesDonnées TMDBForme TMDB v3, plus ratings, moods, soundtracks, wikidata et showtimes via append_to_response
Format de la cléClé v3, 32 caractères hexadécimaux32 caractères hexadécimaux en minuscules
URL de basehttps://api.themoviedb.org/3https://api.amodb.dev/3
Méthodes d'écritureMéthodes de compte, de liste et de notationNon proposées, elles répondent 405

Quand une clé TMDB gratuite suffit

Restez sur une clé TMDB gratuite pour un projet personnel ou d'apprentissage qui respecte les conditions de TMDB. Si votre usage est admissible, TMDB ne coûte rien et amodb ne peut pas rivaliser.

Utilisez une clé amodb quand le projet est commercial et que vous voulez un contrat payant, quand il vous faut une limite fixe par minute pour planifier, ou quand la page d'un titre doit recevoir les notes de cinq sources en un seul appel. Vérifiez d'abord les écarts : les méthodes d'écriture, les flux de changements et quelques autres chemins ne sont pas proposés. Ils sont listés dans alternative à l'API TMDB et dans amodb vs TMDB.

Usage commercial et limites

L'usage commercial est autorisé par les conditions d'utilisation d'amodb. Vous pouvez afficher les données dans vos applications, sites, bots et outils internes, et mettre les réponses en cache pour économiser des requêtes. Vous ne pouvez pas revendre l'accès brut à l'API, publier des exports en masse, partager des clés ni ouvrir des comptes supplémentaires pour augmenter votre débit. La liste complète est dans la politique d'utilisation acceptable.

L'offre fixe le débit. Chaque réponse porte X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset, et une réponse 429 ajoute Retry-After. Les détails sont sur limites de débit.