क्वेरी पैरामीटर URL के प्रश्न चिह्न के बाद का भाग होते हैं — जैसे ?status=open&sort=-created&limit=20। ये किसी भिन्न संसाधन की पहचान नहीं करते; ये उस संसाधन के लिए अनुरोध को संशोधित करते हैं जिसका पथ नामकरण करता है, यही कारण है कि ये फ़िल्टरिंग, सॉर्टिंग, पेजिंग, खोज शब्दों और आउटपुट विकल्पों के लिए पारंपरिक स्थान हैं।
जोड़े & से अलग किए जाते हैं और प्रत्येक मान प्रतिशत-कोडित होता है, इसलिए एक रिक्त स्थान %20 बन जाता है और मान के अंदर एक एम्परसेंड %26 बन जाता है। दोहराई गई कुंजियाँ (?tag=a&tag=b) मान्य हैं लेकिन इनका कोई मानक अर्थ नहीं है — फ्रेमवर्क अलग-अलग तरह से पहली, आखिरी या सभी कुंजियों को रखते हैं। क्योंकि वे URL का हिस्सा हैं, इसलिए वे लॉग, ब्राउज़र इतिहास और कैश में जमा हो जाती हैं।
अज्ञात क्वेरी पैरामीटर हानिरहित होते हैं। कई API गलत वर्तनी वाले फ़िल्टर — जैसे ?stauts=open — को चुपचाप अनदेखा कर देते हैं और सब कुछ लौटा देते हैं, जो सफलता जैसा दिखता है लेकिन क्लाइंट में एक बग होता है। एक सटीक API इसके बजाय 400 का उत्तर देता है; एक परीक्षण से यह जांच होनी चाहिए कि आपका API किस प्रकार का है।
सर्च और फ़ैसेट्स API, GET /search/v1/items पर अज्ञात क्वेरी पैरामीटर को अस्वीकार करता है, जैसा कि फ्रेंड्स v1 कैरेक्टर लिस्ट भी करती है। मूवीज़ API, GET /movies/v1/movies.
सभी शब्द · परीक्षण तकनीकें · सभी 39 मॉक REST API
आखरी अपडेट