POST /search est remplacé par deux endpoints : POST /query et POST /movie. L’ancien endpoint fonctionne encore mais est obsolète.
Le problème avec /search est qu’il faisait deux choses différentes. Parfois il renvoyait une liste de correspondances pour une recherche large ; parfois il renvoyait un seul enregistrement quand le code était exact. Cette ambiguïté rendait l’écriture de clients prévisibles plus difficile.
Maintenant il n’y a plus d’ambiguïté :
POST /queryrenvoie une liste de correspondances ($0,0002/appel). Utilisez-le quand vous avez un nom d’actrice, un titre partiel ou un studio. Chaque résultat aid,dvdId,title,coveretreleaseDate.POST /movierenvoie un seul enregistrement normalisé complet ($0,001/résultat). Même corpsq+providers, mais renvoie la meilleure correspondance avec tous les champs.
Le format du corps de la requête n’a pas changé. Seule l’URL. Le champ providers accepte désormais aussi une chaîne séparée par des virgules en plus d’un tableau JSON. Migrer, c’est simplement changer l’URL.
La séparation a aussi corrigé une incohérence de prix. Les recherches larges sont moins chères car elles renvoient moins de données. Les recherches complètes de films coûtent plus car elles agrègent les métadonnées de plusieurs fournisseurs. Dans les deux cas, vous ne payez que pour HTTP 200. Les échecs sont gratuits.
/search redirige actuellement en interne vers /query. Il sera supprimé dans la prochaine version. Pour la spécification complète de l’API, consultez javinfo.dev/llms.txt.
| Objectif | Ancien endpoint | Nouvel endpoint |
|---|---|---|
| Requête large, veut une liste | /search (obsolète) | POST /query |
| Code exact, veut tous les détails | /search (obsolète) | POST /movie |