Bir yöntemi çağırma
POST veya GET, gövde ve sorgu dizesi ve alan doğrulayıcının beklediği şey.
Yöntem adı URL'nin bir parçasıdır. Kimlik dahil her diğer girdi bir parametredir: POST ile JSON gövdesinde
bir alan, GET ile bir sorgu dizesi parametresi. İki biçim de aynı yönteme ulaşır ve aynı zarfı döndürür.
POST: bir JSON gövdesi
Birkaç parametreden fazlası olan veya iç içe bir nesne ya da dizi içeren her şey için normal biçimdir.
GET: bir sorgu dizesi
Bir tarayıcı adres çubuğundan veya tek satırlık bir curl ile hızlı bir denetim için kullanışlıdır.
Sunucu sorgu dizesini, yöntem işleyicisinin gördüğü aynı gövdeye çözümler; bu yüzden aşağıdaki kurallar
burada POST'tan daha önemlidir.
Bir alanın tanımlı türü, sorgu dizesi değerinin nasıl okunacağını belirler:
- string: olduğu gibi kullanılır.
- number:
Number(...)işleminden geçirilir. - boolean: yalnızca
truesabit dizesitrueolarak okunur.GETile bir boolean alan için ilettiğiniz diğer her şey,falsedahil, doğru değerli bir1'e çevrilir. Bir boolean önemliyse onuPOSTile gerçek bir JSONtrue/falseolarak gönderin ya da yöntemin varsayılanında kalması için sorgu parametresini hiç eklemeyin. - object / array: değer
JSON.parse(...)işleminden geçirilir; bu yüzdenGETile iç içe bir değer, köşeli parantezli sorgu iç içeliği değil, bir JSON dizesi tutan tek bir sorgu parametresi olmalıdır (filters=%7B%22status%22%3A%22open%22%7D).
Zorunlu alanlar ve tür hataları
Bir yöntemin her alanı bir mandatory bayrağı ve bir type taşır. Zorunlu bir alanın eksik olması ya da
POST ile (hiçbir şeyin otomatik dönüştürülmediği yerde) yanlış türün gönderilmesi, yöntemin kendisi
çalışmadan önce size bir -1 döndürür:
Etkileşimli API başvurusu her yöntemin alanlarını türleri ve zorunluluk bayraklarıyla listeler ve oluşturduğu tam isteği görmek için tarayıcıdan bir çağrı çalıştırmanıza izin verir.