Blog

Oleh javinfo team

Desain ulang API: /query dan /movie menggantikan /search

Endpoint /search lama sudah tidak digunakan lagi. Gunakan /query untuk daftar dan /movie untuk hasil tunggal. Semantik lebih bersih, biaya lebih rendah, kontrol sumber eksplisit.

POST /search sedang digantikan oleh dua endpoint: POST /query dan POST /movie. Endpoint lama masih berfungsi tetapi sudah tidak digunakan lagi.

Masalah dengan /search adalah ia melakukan dua hal berbeda. Kadang mengembalikan daftar kecocokan untuk pencarian luas; kadang mengembalikan satu rekaman saat kode tepat. Ambiguitas itu menyulitkan penulisan klien yang dapat diprediksi.

Sekarang tidak ada ambiguitas:

Format body permintaan tidak berubah. Hanya URL-nya. Field providers sekarang juga menerima string yang dipisahkan koma selain array JSON. Migrasi hanya mengganti URL.

Pemisahan juga memperbaiki inkonsistensi harga. Pencarian luas lebih murah karena mengembalikan lebih sedikit data. Pencarian film lengkap lebih mahal karena menggabungkan metadata dari beberapa penyedia. Bagaimanapun, kamu hanya membayar untuk HTTP 200. Kegagalan gratis.

/search saat ini dialihkan secara internal ke /query. Ini akan dihapus di rilis berikutnya. Untuk spesifikasi API lengkap, lihat javinfo.dev/llms.txt.

TujuanEndpoint lamaEndpoint baru
Kueri luas, ingin daftar/search (tidak digunakan)POST /query
Kode tepat, ingin detail lengkap/search (tidak digunakan)POST /movie