GraphQL कई रिसोर्स URL को एक एंडपॉइंट और एक टाइप्ड स्कीमा से बदल देता है। क्लाइंट आवश्यक डेटा के स्वरूप का वर्णन करते हुए एक क्वेरी भेजता है — जैसे कि यह उपयोगकर्ता, उनके पिछले तीन ऑर्डर, प्रत्येक ऑर्डर का कुल योग — और ठीक वही स्वरूप वापस प्राप्त करता है। राइट ऑपरेशन भी म्यूटेशन होते हैं, जिन्हें इसी तरह भेजा जाता है।
सर्वर प्रत्येक क्वेरी को चलाने से पहले अपने स्कीमा के अनुसार मान्य करता है, फिर विभिन्न डेटा स्रोतों से प्रत्येक फ़ील्ड को हल करता है। अनुरोध आमतौर पर JSON बॉडी में क्वेरी के साथ POST फॉर्मेट में होते हैं। त्रुटियों को हल किए जा सकने वाले डेटा के साथ एक त्रुटि सरणी में रिपोर्ट किया जाता है, आमतौर पर पूरे HTTP अनुरोध के लिए 200 स्टेटस के साथ।
GraphQL HTTP स्टेटस कोड की जगह लेता है। चूंकि आंशिक रूप से विफल क्वेरी अभी भी 200 लौटाती है, इसलिए जो क्लाइंट केवल स्टेटस की जांच करता है, वह फ़ील्ड-स्तर की त्रुटियों को पूरी तरह से अनदेखा कर देगा; प्रत्येक प्रतिक्रिया पर त्रुटियों के ऐरे की जांच करनी होगी। इसी लचीलेपन का मतलब यह भी है कि एक ही क्वेरी बहुत महंगी हो सकती है, यही कारण है कि प्रोडक्शन सर्वर गहराई और जटिलता को सीमित रखते हैं।
POST https://funapi.dev/graphql कमांड फ्रेंड्स कैरेक्टर्स पर क्वेरी और म्यूटेशन चलाता है, साथ ही उसी URL पर एक ग्राफीक्यूएल एक्सप्लोरर भी उपलब्ध है; फ्रेंड्स एपीआई डॉक्स पेज पर 'ट्राई इट आउट' पैनल में इसे POST /graphql के रूप में भी चलाया जा सकता है।
सभी शब्द · परीक्षण तकनीकें · सभी 39 मॉक REST API
आखरी अपडेट