कर्सर पेजिनेशन

कर्सर पेजिनेशन एक पेजिनेशन रणनीति है जो परिणाम सेट में किसी स्थान को चिह्नित करने के लिए एक अपारदर्शी टोकन (एक "कर्सर") का उपयोग करती है, न कि page=2 या offset=100 जैसे संख्यात्मक ऑफसेट पर निर्भर रहती है। क्लाइंट अगला पृष्ठ अनुरोध करने के लिए कर्सर को सर्वर को वापिस भेजते हैं (उदाहरण के लिए after_cursor पैरामीटर के माध्यम से)। सर्वर अपनी प्रतिक्रिया में अगले पृष्ठ के लिए एक नया कर्सर लौटाता है।

प्रसंग में

Polymarket के Gamma /markets endpoint में कर्सर-आधारित पेजिनेशन अनिवार्य है: कॉल्स को पिछले अनुरोध द्वारा लौटाए गए after_cursor मान का उपयोग करना चाहिए, न कि offset पैरामीटर। यह keyset-शैली तरीका बड़े या बार-बार अपडेट होने वाले परिणाम सेटों पर प्रदर्शन और स्थिरता में सुधार करता है क्योंकि सर्वर हर पृष्ठ के लिए शुरुआत से स्कैन किए बिना एक स्थिर स्थान से फिर से शुरू कर सकता है। Gamma हर पृष्ठित प्रतिक्रिया में एक next_cursor लौटाता है; अगले पृष्ठ को लाने के लिए उस मान को after_cursor के रूप में प्रदान करें।

व्यावहारिक नोट्स

अपारदर्शी टोकन: कर्सर को एक बिना-जाँचे हुए स्ट्रिंग की तरह संभालें। क्लाइंट साइड पर इसे पार्स या बनाकर कोशिश न करें।
कोई संख्यात्मक ऑफसेट नहीं: Gamma API संख्यात्मक offset को अस्वीकार करता है; /markets के साथ पेजिनेशन के लिए after_cursor का उपयोग करें। यह endpoint after_cursor के साथ limit (max 1000) का समर्थन करता है।
क्रम का महत्व: कर्सर पेजिनेशन क्वेरी के ordering से जुड़ा होता है। यदि आप order fields बदलते हैं तो आप पहले के कर्सर का उपयोग करके पुनः शुरू न कर पाएं।
मजबूत क्लाइंट: यदि आप लंबा स्कैन फिर से शुरू करने का इरादा रखते हैं तो कर्सर सहेजें, और उस स्थिति को संभालें जहाँ पहले जारी किया गया कर्सर पुराने हो जाए या कोई परिणाम न दे।

यह भी देखें

/glossary/gamma-api

संबंधित शब्द