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 |