POST /search заменяется двумя эндпоинтами: POST /query и POST /movie. Старый эндпоинт всё ещё работает, но устарел.
Проблема с /search была в том, что он делал две разные вещи. Иногда он возвращал список совпадений для широкого поиска; иногда возвращал одну запись, когда код был точным. Эта неоднозначность усложняла написание предсказуемых клиентов.
Теперь неоднозначности нет:
POST /queryвозвращает список совпадений ($0.0002/вызов). Используйте, когда у вас есть имя актрисы, часть названия или студия. Каждый результат содержитid,dvdId,title,coverиreleaseDate.POST /movieвозвращает одну полную нормализованную запись ($0.001/результат). Тело запроса то же —q+providers, но возвращается одно лучшее совпадение со всеми полями.
Формат тела запроса не изменился. Только URL. Поле providers теперь также принимает строку с разделителями-запятыми в дополнение к JSON-массиву. Миграция — это просто замена URL.
Разделение также исправило ценовую несогласованность. Широкие поиски дешевле, потому что возвращают меньше данных. Полные запросы фильмов стоят дороже, потому что агрегируют метаданные от нескольких провайдеров. В любом случае, вы платите только за HTTP 200. Ошибки бесплатны.
/search в настоящее время внутренне перенаправляется на /query. Он будет удалён в следующем релизе. Полную спецификацию API смотрите на javinfo.dev/llms.txt.
| Цель | Старый эндпоинт | Новый эндпоинт |
|---|---|---|
| Широкий запрос, нужен список | /search (устарел) | POST /query |
| Точный код, нужны детали | /search (устарел) | POST /movie |