Sorgu parametreleri

Sorgu parametreleri URL’nin soru işaretinden sonraki kısmıdır: ?status=open&sort=-created&limit=20. Farklı bir kaynağı tanımlamazlar; yolun adlandırdığı kaynağa yapılan isteği değiştirirler. Bu yüzden filtreleme, sıralama, sayfalama, arama terimleri ve çıktı seçenekleri için alışılmış yer burasıdır.

Nasıl çalışır

Çiftler & ile ayrılır ve her değer yüzde kodlamasıyla yazılır; boşluk %20, bir değerin içindeki & ise %26 olur. Tekrarlanan anahtarlar (?tag=a&tag=b) geçerlidir ama standart bir anlamı yoktur — çatılar ilkini, sonuncusunu ya da hepsini tutar. URL’nin parçası oldukları için loglara, tarayıcı geçmişine ve önbelleklere girerler.

Yaygın yanılgı

Bilinmeyen sorgu parametrelerinin zararsız olduğu sanılır. Pek çok API yanlış yazılmış bir filtreyi (?stauts=open) sessizce yok sayar ve her şeyi döndürür; bu başarı gibi görünür ama istemcide bir hatadır. Katı bir API bunun yerine 400 döner; test, sizinkinin hangisi olduğunu kontrol etmeli.

Burada deneyin

Search & Facets API’si GET /search/v1/items üzerinde bilinmeyen sorgu parametrelerini reddeder; Friends v1 karakter listesi de öyle. Movies API’si GET /movies/v1/movies üzerinde filtreleme, sıralama ve sayfalamayı birleştirir.

İlgili

Kaynaklar

Diğer terimler

REST API — Bir sistemi adreslenebilir kaynaklar olarak modelleyen ve onları standart HTTP metotlarıyla değiştiren API.
API uç noktası (endpoint) — Bir URL ile bir HTTP metodunun birleşimi — bir istemcinin çağırabileceği en küçük API birimi.
Yollar — Bir URL yolunun, /orders/42’deki 42 gibi, belirli bir kaynağı tanımlayan değişken parçası.
HTTP — Her istek ve yanıtla birlikte, gövdeden ayrı olarak gönderilen ad–değer üst verisi.
HTTP durum kodları — Her HTTP yanıtının başındaki, gövdeden önce ne olduğunu söyleyen üç haneli sayı.
İçerik uzlaşımı — İstemci ile sunucunun yanıtın biçiminde, ayrı adresler üzerinden değil başlıklarla anlaşması.

Bu sayfayı İngilizce okuyun

Tüm sözlük maddeleri · Test teknikleri · 39 mock REST API’nin tamamı

Son güncelleme 16 Ekim 2026