"रियल-टाइम" लोकेशन डेटा के लिए वास्तव में क्या चाहिए
रियल-टाइम को तेज़ के पर्याय के रूप में इस्तेमाल किया जाता है। इसका अर्थ यह होना चाहिए कि उत्तर दुनिया की मौजूदा स्थिति को दर्शाता है, पिछली तिमाही की तस्वीर को नहीं।
टैग
#api-डिज़ाइन
हम null और कम कॉन्फ़िडेंस वाले परिणामों को कैसे संभालते हैं
जब किसी क्वेरी को सचमुच भरोसेमंद तरीके से रिज़ॉल्व नहीं किया जा सकता, तो कुछ न लौटाना तथ्य के रूप में सजाया गया अनुमान लौटाने से बेहतर जवाब है। यहाँ उस चुनाव के पीछे का तर्क है।
ऊँचाई डेटा को बाद की सोच क्यों माना जाता है
ऊँचाई डेटा को प्राइसिंग पेज पर शायद ही कभी अपनी अलग पंक्ति मिलती है, और यह गैरमौजूदगी आपको कुछ सच बताती है कि उसे वास्तव में कितनी गंभीरता से बनाया जाता है।
बुनियादी ऑथेंटिकेशन तरीकों के लिए अतिरिक्त शुल्क लेने के ख़िलाफ़ तर्क
हेडर, bearer टोकन और क्वेरी पैरामीटर, तीनों किसी अनुरोध को एक ही तरह ऑथेंटिकेट करते हैं। इनमें से किसी एक के लिए ज़्यादा शुल्क लेना किसी सुविधा का नहीं, बल्कि एक पसंद का शुल्क लेना है।
प्रोवाइडर बदलने पर रेट लिमिट में किन अंतरों की उम्मीद करें
अलग-अलग प्रोवाइडर में रेट लिमिट केवल संख्या में नहीं, संरचना में भी अलग होती हैं। यह मानने से पहले कि आपका मौजूदा तर्क अब भी लागू होता है, यहाँ बताया गया है कि क्या जाँचें।
हम गलत अनुमान के बजाय एरर से जवाब देना क्यों पसंद करते हैं
आत्मविश्वास से भरा दिखने वाला गलत उत्तर ईमानदार विफलता से बुरा है। एरर आपको कुछ जाँचने को कहता है। आत्मविश्वास से भरा गलत अनुमान आपको बताता है कि कुछ भी गलत नहीं है।
क्लाइंट को छुए बिना सर्वर-साइड इंटीग्रेशन माइग्रेट करना
सर्वर-साइड जियोकोडिंग माइग्रेशन अक्सर उस पर निर्भर क्लाइंट एप्लिकेशन के लिए अदृश्य रह सकता है। यहाँ बताया गया है कि इसे उस तरह कैसे डिज़ाइन करें।
प्रति देश मूल्य टियर एक बुरा विचार क्यों हैं
किसी एक देश में पता देखने के लिए दूसरे देश से ज़्यादा शुल्क लेना भूगोल को ही मूल्य तय करने का हथियार बना देता है, बजाय इसके कि उसे सामान्य, साधारण डेटा की तरह दिया जाए।
पिन कोड लुकअप को प्रमुख सुविधा मानने के पक्ष में तर्क
जिस पिन कोड एंडपॉइंट का मूल्य और दस्तावेज़ बाद की सोच की तरह तय किए जाते हैं, वह बनाया भी वैसे ही जाएगा। इसे गंभीरता से लेने की शुरुआत इसे बराबरी का दर्जा देने से होती है।
यह उद्योग IPv6 अपनाने में अब भी क्या गलत करता है
जो IP लुकअप API अब भी IPv6 को एक मामूली विशेष मामला मानता है, वह चुपचाप असली इंटरनेट ट्रैफ़िक के बढ़ते हिस्से को बाद की सोच मान रहा है।
खाता-स्तर और नेटवर्क-स्तर, दोनों कोटा क्यों होने चाहिए
खाता-स्तर का कोटा यह ट्रैक करता है कि आप कौन हैं। नेटवर्क-स्तर का कोटा यह ट्रैक करता है कि आपका ट्रैफ़िक वास्तव में कहाँ से आता है। एक गंभीर सिस्टम को दोनों चाहिए।
हर एंडपॉइंट पर एक साफ़ एरर फ़ॉर्मेट
हर एंडपॉइंट अब एक ही, एकरूप फ़ॉर्मेट में एरर लौटाता है, जिससे विफलताओं को पहचानना, लॉग करना और प्रोग्राम के ज़रिए संभालना आसान हो जाता है।
केवल वेबहुक वाले API चुपचाप बैच उपयोगकर्ताओं को बाहर क्यों कर देते हैं
वेबहुक एक समय में एक अनुरोध के लिए अच्छा काम करता है। यह उस स्क्रिप्ट के लिए बुरा काम करता है जो बस हज़ार लुकअप भेजना और हज़ार उत्तरों का इंतज़ार करना चाहती है।
हम अपने एरर कोड छिपाने के बजाय प्रकाशित क्यों करते हैं
बिना दस्तावेज़ वाला एरर कोड हर विफल अनुरोध को अंदाज़ा लगाने का खेल बना देता है। सूची प्रकाशित करना एक छोटी बात है जो डिबगिंग का असली समय बचाती है।
बैच मूल्य एकल अनुरोध के मूल्य के बराबर क्यों होना चाहिए
एक-एक करके भेजे गए हज़ार लुकअप और बैच के रूप में भेजे गए हज़ार लुकअप उतना ही काम हैं। कीमत इस पर निर्भर नहीं होनी चाहिए कि उन्हें कैसे पैक किया गया।
उबाऊ, स्थिर API वर्ज़निंग के पक्ष में तर्क
एक रोमांचक नया API वर्ज़न उस पर निर्भर हर किसी के लिए एक माइग्रेशन प्रोजेक्ट है। उबाऊ, स्थिर वर्ज़निंग एक सुविधा है, महत्वाकांक्षा की कमी नहीं।
हमने सबसे पहले ब्राउज़र SDK क्यों नहीं बनाया
सर्वर-साइड लुकअप के लिए ब्राउज़र SDK ज़्यादातर बस आपकी API कुंजी को ऐसी जगह ले जाता है जहाँ विज़िटर का ब्राउज़र उसे देख सकता है। यह कोई ऐसी सुविधा नहीं है जो रखने लायक हो।
नेटवर्क-स्तर की रेट लिमिटिंग वह क्या हल करती है जो प्रति कुंजी सीमाएँ नहीं करतीं
केवल प्रति कुंजी सीमा यह मानकर चलती है कि एक कुंजी का मतलब एक उपयोगकर्ता है। नेटवर्क के हिसाब से रेट लिमिटिंग उस खामी को बंद करती है जहाँ यह धारणा चुपचाप टूट जाती है।
पिन कोड को जितना सम्मान मिलता है, वे उससे ज़्यादा के हक़दार हैं
पिन कोड लुकअप को जियोकोडिंग के सामने एक मामूली उपयोगिता माना जाता है, लेकिन उनमें असली संरचना और असली क्षेत्रीय विविधता होती है जो उतनी ही सावधानी की हक़दार है।
दस्तावेज़ों की गुणवत्ता सुविधाओं की संख्या से ज़्यादा मायने क्यों रखती है
जिस सुविधा का उपयोग करना आप समझ नहीं पाते, वह न होने के बराबर है। दस्तावेज़ सपोर्ट की लागत नहीं हैं, वे असली प्रोडक्ट का हिस्सा हैं।
वेंडर लॉक-इन की छिपी कीमत
लॉक-इन शायद ही कभी एक बुरे फ़ैसले के रूप में दिखता है। यह सौ छोटे फ़ैसलों के रूप में दिखता है जो चुपचाप छोड़कर जाने की कीमत वहीं बने रहने से कहीं ज़्यादा कर देते हैं।
रेट लिमिट दस्तावेज़ में लिखी होनी चाहिए, खोजनी नहीं पड़नी चाहिए
प्रोडक्शन में 429 एरर के ज़रिए अपनी रेट लिमिट का पता चलना दस्तावेज़ नहीं है। यह एक ऐसा सपोर्ट टिकट है जिसकी कभी ज़रूरत ही नहीं पड़नी चाहिए थी।
हम बल्क अनुरोधों को प्रति कॉल नहीं, प्रति आइटम क्यों गिनते हैं
हज़ार पतों वाली बैच कॉल भी हज़ार अलग लुकअप करती है। उसे एक अनुरोध गिनना बस यह छिपा देगा कि असली उपयोग वास्तव में कहाँ गया।
मालिकाना रिस्पॉन्स फ़ॉर्मेट के ख़िलाफ़ तर्क
मालिकाना फ़ील्ड नाम या कस्टम ऑब्जेक्ट मॉडल से प्रोवाइडर का कुछ नहीं बचता और ग्राहक को बाद में दोबारा लिखना पड़ता है। सादा, अनुमान लगाने योग्य JSON कोई कमी नहीं है।
प्रति प्रोडक्ट बिलिंग API के उपयोग के तरीके के बारे में क्या गलत समझती है
असली एप्लिकेशन एक ही अनुरोध पाथ में जियोकोडिंग, IP लुकअप और समय क्षेत्र कॉल मिलाते हैं। इन्हें अलग प्रोडक्ट के रूप में बिल करना इस बात को नज़रअंदाज़ करता है कि इनका उपयोग साथ-साथ कैसे होता है।
ओपन समय क्षेत्र डेटा प्रीमियम सुविधा नहीं होना चाहिए
समय क्षेत्र लुकअप एक सार्वजनिक, सक्रिय रूप से अपडेट होने वाले डेटा स्रोत पर चलते हैं। उस लुकअप के लिए अलग प्रीमियम लेना किसी असली अतिरिक्त लागत को नहीं दर्शाता।
कम्पैटिबिलिटी होस्ट नए SDK से ज़्यादा मायने क्यों रखते हैं
SDK आपसे अपने प्रोजेक्ट के पूरे जीवनकाल के लिए एक कंपनी की क्लाइंट लाइब्रेरी पर भरोसा करने को कहता है। कम्पैटिबिलिटी होस्ट आपसे कॉन्फ़िगरेशन की एक पंक्ति बदलने को कहता है।
हमने इसका मूल्य प्रति सीट नहीं, प्रति अनुरोध क्यों रखा
प्रति अनुरोध मूल्य उस लागत से मेल खाता है जो किसी API को चलाने में वास्तव में लगती है। सीट के हिसाब से मूल्य कर्मचारियों की संख्या मापता है, उपयोग नहीं, और जियोकोडिंग ट्रैफ़िक शायद ही कभी इनमें से किसी के अनुसार चलता है।