क्रमबद्ध करना (Sorting)
JSON:API एक ही अनुरोध में कई संसाधनों को प्राप्त करना संभव बनाता है, इन रूट्स को "collection" रूट्स कहा जाता है। कोई भी व्यक्ति बेस resource रूट पर GET अनुरोध भेजकर संसाधनों का एक संग्रह प्राप्त कर सकता है, जैसे: GET /jsonapi/node/article
और इसमें UUID शामिल नहीं होता। डिफ़ॉल्ट रूप से, इसमें निर्दिष्ट प्रकार के सभी संसाधन शामिल होंगे।
Filtering और Sorting सभी मानक संसाधनों पर डिफ़ॉल्ट रूप से उपलब्ध हैं।
हेडर
सही JSON:API अनुरोध और प्रतिक्रिया प्राप्त करने के लिए सभी GET अनुरोधों पर निम्नलिखित हेडर अनिवार्य हैं:
-
Accept: application/vnd.api+json
-
Content-Type: application/vnd.api+json
उदाहरणों के काम करने के लिए निम्नलिखित हेडर की आवश्यकता है:
-
Authorization: Basic YXBpOmFwaQ==
संग्रह (collections) को क्रमबद्ध करना
'created' द्वारा क्रमबद्ध करना
किसी संग्रह को उसके "created" टाइमस्टैम्प द्वारा क्रमबद्ध करें (डिफ़ॉल्ट रूप से ascending क्रम में)।
SHORT
sort=created
NORMAL
sort[sort-created][path]=created
लेखक के यूज़रनेम द्वारा क्रमबद्ध करना
किसी संग्रह को लेखक के यूज़रनेम द्वारा descending क्रम में क्रमबद्ध करें। ध्यान दें कि प्रारंभिक "माइनस" चिन्ह (-) descending क्रम निर्दिष्ट करता है।
SHORT
sort=-uid.name
NORMAL
sort[sort-author][path]=uid.name
sort[sort-author][direction]=DESC
कई फ़ील्ड्स द्वारा क्रमबद्ध करना
किसी संग्रह को कई फ़ील्ड्स द्वारा क्रमबद्ध करें।
SHORT
sort=-created,uid.name
NORMAL
sort[sort-created][path]=created
sort[sort-created][direction]=DESC
sort[sort-author][path]=uid.name
लेख स्रोत: Drupal Documentation।