Pertanyaan: Untuk API web yang menghadap publik (mengirim permintaan Dapatkan / Posting HTTP, dapatkan kembali data JSON / XML), bagaimana seharusnya parameter ditangani yang salah eja atau ekstra.
Sepertinya saya bahwa jika parameter yang salah diabaikan, kesalahan dalam kode pemanggil mungkin tidak diperhatikan karena mereka akan mendapatkan kembali hasil yang valid. Ini mungkin benar terutama dalam situasi di mana itu tidak akan terlihat dengan melihat hasil yang dikembalikan.
Saya mengacu pada parameter opsional saja. Jelas jika parameter yang diperlukan salah eja, maka parameter akan dianggap hilang dan kesalahan akan dikembalikan.
Sebagai contoh , panggilan Place Search API memiliki empat parameter yang diperlukan (lokasi, jari-jari, sensor, dan kunci) dan beberapa parameter opsional (tipe adalah salah satunya).
Saya dapat menjalankan perintah ini (dengan kunci API) dan mendapatkan kembali hasil yang valid:
curl "https://maps.googleapis.com/maps/api/place/search/json?location=45.47554,-122.794189&radius=500&sensor=false&key=<api_key>&type=bakery"
curl "https://maps.googleapis.com/maps/api/place/search/json?location=45.47554,-122.794189&radius=500&sensor=false&key=<api_key>&types=bakery"
Perintah pertama memiliki parameter "types" dalam bentuk singular yang merupakan nama kunci yang tidak valid. API mengabaikan parameter itu dan mengembalikan semua jenis entitas. Dalam hal ini kesalahannya jelas, tetapi mungkin ada waktu (dan panggilan API lainnya) di mana tidak akan terjadi.