Блог

Автор javinfo team

Редизайн API: /query и /movie заменяют /search

Старый эндпоинт /search устарел. Используйте /query для списков и /movie для отдельных результатов. Чище семантика, ниже стоимость, явный контроль источников.

POST /search заменяется двумя эндпоинтами: POST /query и POST /movie. Старый эндпоинт всё ещё работает, но устарел.

Проблема с /search была в том, что он делал две разные вещи. Иногда он возвращал список совпадений для широкого поиска; иногда возвращал одну запись, когда код был точным. Эта неоднозначность усложняла написание предсказуемых клиентов.

Теперь неоднозначности нет:

Формат тела запроса не изменился. Только URL. Поле providers теперь также принимает строку с разделителями-запятыми в дополнение к JSON-массиву. Миграция — это просто замена URL.

Разделение также исправило ценовую несогласованность. Широкие поиски дешевле, потому что возвращают меньше данных. Полные запросы фильмов стоят дороже, потому что агрегируют метаданные от нескольких провайдеров. В любом случае, вы платите только за HTTP 200. Ошибки бесплатны.

/search в настоящее время внутренне перенаправляется на /query. Он будет удалён в следующем релизе. Полную спецификацию API смотрите на javinfo.dev/llms.txt.

ЦельСтарый эндпоинтНовый эндпоинт
Широкий запрос, нужен список/search (устарел)POST /query
Точный код, нужны детали/search (устарел)POST /movie