एपीआई सेवाएं Mangomag.ru

यह लेख हमारी साइट की एपीआई सेवाओं के विकास पर ध्यान केंद्रित करेगा - उनके प्लसस और मिन्यूज़, साथ ही उन समस्याओं के बारे में जो हमने उन्हें बनाने और सुधारने की प्रक्रिया में सामना किया।

यह सबसे बुनियादी एपीआई के बारे में होगा, जिसके बिना हमारे ग्राहकों को चीनी (और अंग्रेजी) सीखना होगा, और उत्पादों का चयन एक ही सुविधाजनक इंटरफ़ेस में नहीं करना चाहिए, लेकिन "उत्पादों के लिंक को फेंककर" आदेश दें, क्योंकि यह कुछ अन्य साइटों पर लागू होता है।

चर्चा की जाएगी कि एपीआई की सूची :

1) चीनी और अंग्रेजी से रूसी में अनुवाद सेवा;
2) ईबे एपीआई;
3) अमेज़ॅन एपीआई;
4) Taobao एपीआई;
5) एलिएक्सप्रेस एपीआई;
6) पार्सल ट्रैकिंग सेवा।


चलो सबसे महत्वपूर्ण से शुरू करते हैं - चीनी और अंग्रेजी से रूसी में अनुवाद सेवा।

नीचे की कहानी गधे के साथ एक ऊदबिलाव के शाश्वत संघर्ष के बारे में जाएगी, ठीक है, आप समझते हैं। )

प्रारंभ में, अच्छा पुराना Google Translate API साइट पर ले जाया गया था, और, स्पष्ट रूप से, हम इससे काफी खुश थे। स्थिर काम, पर्याप्त अनुवाद। लेकिन सब मुफ्त है, किसी दिन समाप्त होता है। सेवा का भुगतान हो गया, और अच्छे निगम के बहते नोटों को देखते हुए, हमने महसूस किया कि यह कुछ नया करने का प्रयास करने का समय था।
और फिर किसी को Microsoft बिंग अनुवादक एपीआई याद आया। यह विचार बुरा नहीं था, और यद्यपि समीक्षाएँ मिश्रित थीं, हम उत्साह के साथ व्यापार में उतर गए। सबसे हर्षित पूर्वाभास से भरा, हमने नए एपीआई का परीक्षण शुरू किया ...

खैर, हमारे मामले में, एक गंभीर समस्या सामने आई: अनुवादक ने टैगों को नहीं पहचाना, इसलिए विवरण केवल अनुवाद किए गए थे यदि अत्यधिक प्रारूपण का उपयोग नहीं किया गया था या लेआउट 100% वैध था (जो कि आप समझते हैं, 99% में ऐसा नहीं है)।
एक छोटी उत्पादन बैठक के बाद, कार्य निगम के गुड्स में लौटने के लिए निर्धारित किया गया था, लेकिन किसी तरह उप-लिफाफे से, ताकि कोई गोल मात्रा न हो।

हमारे कठोर प्रोग्रामर, जो प्रयोज्यता के लिए लड़ाइयों में तड़प रहे थे, एक नुकसान में नहीं थे और इस विकल्प का सुझाव दिया: नीलामी साइटों के श्रेणियों और मापदंडों का अनुवाद करते समय Google API का उपयोग करें, और उसी Google से साइटों के लिए अनुवाद टूल का उपयोग करके विवरण का अनुवाद करें (http://tllate.google) .com / प्रबंधक / वेबसाइट / सुझाव)। जल्दी से नहीं कहा। मुख्य लेखाकार ने आखिरकार एक सपना देखा, क्योंकि अगर सब कुछ काम करता है, तो लागत में काफी कमी आएगी।

लेकिन ...

"टैम्बोरिन के साथ परीक्षण और नृत्य करने के एक महीने बाद, हम इस निष्कर्ष पर पहुंचे कि यह बात काम नहीं करती है ..." (ग) समय सीमा के दिन वरिष्ठ प्रोग्रामर।



नहीं, वर्णनों के अनुवाद सभ्य थे, लेकिन, यहाँ, विकल्पों और श्रेणियों के अनुवाद ने संघटन में एक परिष्कृत खेल जैसा बना दिया। विशेष रूप से, यह चीनी कैटलॉग में ध्यान देने योग्य था।

क्या आप "चयनित ज्ञान वर्ग" या "ब्लॉक बॉक्स कुंजी बॉक्स" श्रेणी के उत्पादों को ऑर्डर करना चाहेंगे? और "अच्छा वापस जाओ"? स्वास्थ्य मंत्रालय चेतावनी देता है, इसके बारे में बहुत लंबा न सोचें कि इसका क्या मतलब है।

संभावनाओं और लागतों, साथ ही साथ हमारे प्रोग्रामरों के न्यूरो-भौतिक स्थिति का विश्लेषण करने के बाद, जब से काटज़ ने हमेशा हार मान ली, हमने चीनी साइटों के लिए सभी श्रेणियों के मापदंडों और नामों के अनुवाद को आउटसोर्स करने का फैसला किया, और श्रेणियों और अमेरिकी संसाधनों के मापदंडों का हिस्सा। हमने Google API के माध्यम से शेष आंतरिक का अनुवाद पुराने ढंग से शुरू करने का निर्णय लिया।
और यह सब काम किया। खैर, लगभग।

अनुवाद के साथ सब कुछ अद्भुत था। लेकिन एक नई समस्या उत्पन्न हुई: व्यवस्थापक पैनल के माध्यम से एक आदेश की पुष्टि करते समय, प्रबंधक को विक्रेता की मूल वेबसाइट पर उत्पाद कार्ड की जांच करनी होगी और, यदि चयनित विकल्पों का क्रम मेल नहीं खाता है, तो विक्रेता के साथ जांचें कि क्या इस प्रकार, उपकरण, स्टॉक में रंग आवश्यक मात्रा में था।

लेकिन सिस्टम छोड़ने का फैसला किया गया था। चूंकि, करीबी परीक्षा में, यह मूल्य / गुणवत्ता अनुपात के मामले में सबसे अच्छा विकल्प निकला। यहां तक ​​कि आदेशों को संसाधित करने के लिए समय प्रबंधकों की लागत को ध्यान में रखते हुए (मुख्य लेखाकार गारंटी!)।
तो यह शिक्षाप्रद कहानी अच्छी तरह से समाप्त हो गई।

खैर, हमारे लेख का अगला भाग चार स्तंभों के लिए समर्पित है, जिस पर Mangomag.ru टिकी हुई है: अमेज़ॅन एपीआई, ईबे एपीआई, Taobao एपीआई और एलिएक्सप्रेस एपीआई।

उन दिनों में जब परियोजना बस शुरू हो रही थी, हमारे प्रोग्रामर ने अपने मालिकों को आश्वस्त किया कि मसोचवाद हमेशा उचित नहीं है और खरोंच से कोड लिखने के बजाय रेडीमेड एपीआई सेवा लेना बेहतर है (यदि सेवा विश्वसनीय है और आवश्यकताओं को संतुष्ट करती है)। इसके अलावा, वाईआईई फ्रेमवर्क, जिसके आधार पर साइट बनाई गई है, आपको जल्दी से कार्यक्षमता जोड़ने की अनुमति देता है।

अधिकारियों को विशेष रूप से मूल्यवान जानकारी के अंतिम टुकड़े (कार्यक्षमता के परिचालन जोड़ के बारे में) के साथ प्यार हो गया। और तब से, प्रत्येक बैठक के बाद, मेगाप्लान ने उन प्रभारियों को खुशी से स्पैम किया ("हमें चित्रों के रूप में एक रेटिंग आउटपुट फ़ंक्शन की आवश्यकता है", "हमें एक आकार कैलकुलेटर की आवश्यकता है", "हमें उत्पाद तस्वीरों के लिए सुविधाजनक स्लाइडर की आवश्यकता है", आदि), लेकिन एक और कहानी है ...

इसलिए, रेडी-मेड एपीआई का उपयोग करने के लिए आगे बढ़ने, हमारे प्रोग्रामर, यहां तक ​​कि दाढ़ी वाले, दो अमेरिकी सेवाओं (ईबे एपीआई और अमेज़ॅन एपीआई) के साथ शुरू हुए। जाहिरा तौर पर, परियोजना प्रबंधक ने अनुमान लगाया कि बाद में Taobao एपीआई और एलिएक्सप्रेस एपीआई के लुगदी को छोड़ना बेहतर था।

सामान्य तौर पर, अमेरिकियों के साथ कोई विशेष समस्याएं नहीं थीं।
अमेज़ॅन एपीआई के साथ एक छोटी सी अड़चन थी, कार्यों की एक बहुतायत के साथ जुड़ा हुआ था जिसे समझने की आवश्यकता थी। सामान्य तौर पर, सेवा ने वास्तव में मुझे इस तथ्य से प्रभावित किया कि, यदि आप चाहें, तो आप न केवल उत्पादों के बारे में जानकारी एकत्र कर सकते हैं, बल्कि वास्तव में किसी भी विषयगत पोर्टल के आधार पर स्टोर फ्रैंचाइज़ी बना सकते हैं। लेकिन हम स्वाभाविक रूप से डेटा में ही रुचि रखते थे, और जिन मापदंडों से यह संभव था कि वे इसे फ़िल्टर कर सकते थे, जिसे हमने छोड़ दिया।

सफलतापूर्वक पंगा लेने और अमेज़ॅन को डीबग करने के बाद, हमने ईबे को लिया। यहां, प्रोग्रामरों को थोड़ा जादू करना पड़ा, क्योंकि विकास के इस चरण में हम इस निष्कर्ष पर पहुंचे कि साइट के प्रशासनिक हिस्से में विभिन्न स्टोरों से अलग-अलग पदों के आदेशों को तोड़ना आवश्यक है। यह इस तथ्य के कारण था कि विक्रेताओं से सीधे भेजे गए सामान संयुक्त राज्य में एक गोदाम में जाने वाले लोगों की तुलना में एक अलग सूची पर जाते हैं। और हमारे प्रबंधक सीधे शिपमेंट के मामले में खाली मान डालकर थक गए हैं।

डेवलपर्स ने निराश नहीं किया और, उत्साह के मद्देनजर, एक मार्जिन के साथ गोदाम व्यवस्थापक क्षेत्र की क्षमताओं का विस्तार किया। वोइला! समस्या को हल करने के अलावा (अनावश्यक प्रक्रियाओं के माध्यम से सीधे भेजे गए सामान), अब व्यापार प्रक्रिया के पांच और चरण हैं (खरीदार के लिए फोटो अपलोड करना और आदेश की स्थिति पर टिप्पणी करने के लिए एक विस्तारित प्रणाली - वास्तव में एक व्यक्तिगत प्रबंधक और एक खरीदार के बीच एक चैट सहित)।

पुरस्कार पहले से ही प्रोग्रामर के हाथों में है, हर कोई खुश और खुश है, लेकिन, अब, Taobao एपीआई ने भयानक ...



पिछली सफलता को देखते हुए, हम पूर्ण विश्वास के साथ Taobao एपीआई में आए - अब हम एक त्वरित में जुड़ेंगे और आप छुट्टी ले सकते हैं। लेकिन हम दो बाधाओं से मिले थे: नौकरशाही और भाषाई।

हमने सबसे पहले उस लोकप्रिय ज्ञान को याद किया, जिसमें वे अपने स्वयं के चार्टर के साथ एक अजीब मठ में नहीं चढ़ते थे। और हमने अपने चीनी सहयोगियों को चीनी नौकरशाही से लड़ने के लिए भेजा। अंत में, उनका कुंग फू ठंडा हो गया, जो आनन्दित नहीं कर सकता है।

भाषा बाधा इस तथ्य में प्रकट हुई थी कि एपीआई प्रलेखन बदलती गंभीरता के चित्रलिपि का एक सेट था। वैज्ञानिक प्रहार विधियों का उपयोग करने के जोखिम के बिना, हमने आकाशीय भाषा से मानव तक प्रलेखन के अनुवाद को आउटसोर्स करने का निर्णय लिया। कंपनी को हमने सफलतापूर्वक कार्य के साथ मुकाबला किया, और भविष्य में वह वह थी जिसने साइट की श्रेणियों के अनुवाद के साथ हमारी मदद की।

इसलिए, दस्तावेज़ का अनुवाद किया गया है, ग्रीन कॉरिडोर खुला है, सेवा खराब हो गई है और काम कर रही है, अमेरिकी एपीआई बहुत पीछे नहीं हैं, डेवलपर्स ने पहले ही शैंपेन की एक बोतल का अनावरण किया है ...

तो, रुकिए, वादा किया गया Aliexpress API कहाँ है? बिलकुल ठीक। वह वहां नहीं है। यह अभी अस्तित्व में नहीं है, जिसका अर्थ है कि एक और महीना आगे है।

पहला विकल्प इस तरह दिखता था: हम कर्ल का उपयोग करके पृष्ठ लेते हैं और सभी मापदंडों को डेटाबेस में ले जाते हैं, श्रेणियों को कैश करते हैं और फिर से सभी मापदंडों को मक्खी पर अनुवाद करते हैं। लेकिन फिर साइट पर एक नया खंड दिखाई देता है, जहां कार्ड को अलग तरीके से सजाया जाता है। खैर, जहां हमारा गायब नहीं हुआ, हम एक नया पार्सर बनाते हैं।

अब तंत्र Aliexpress के लगभग सभी वर्गों के साथ मुकाबला करता है। खैर, अगर एक नई श्रेणी दिखाई देती है, तो मौजूदा पार्सर को समायोजित करना खरोंच से समाधान की तुलना में बहुत आसान है, जो शुरुआती चरणों में था।

सामान्य तौर पर, अलिएक्सप्रेस प्लेटफॉर्म के साथ काम करना सरल हो गया, क्योंकि सब कुछ सरल है, क्योंकि हमारे पास पहले से ही चीन से एक मंच था। सादगी क्या है? हां, कि Aliexpress में ड्रॉप शिपिंग है। हां, इसमें अधिक समय लगता है, और भले ही पार्सल को समेकित करना असंभव है, लेकिन जब तक पोषित पार्सल निकटतम डाकघर में नहीं है, तब तक किसी के लिए "ऑर्डर करना और भूलना" आसान है। और स्पष्ट रूप से, चीन में गोदाम को उतारना हमारे हाथ में था।

तो, यहाँ यह सब समाप्त हो गया, हालांकि जल्दी नहीं, लेकिन अच्छा है।

और हमारी अंतिम कहानी पैकेज ट्रैकिंग सेवा की किंवदंती है ।



पहले आदेशों और पार्सल की स्थिति के बारे में बार-बार पूछे जाने वाले सवालों के बाद, हमारे बुद्धिमान परियोजना प्रबंधक ने महसूस किया कि यह वह था जिसने ग्राहक को पूर्ण निर्वाण हासिल करने की अनुमति नहीं दी थी। और बैठक में उन्होंने ऐसा विचार व्यक्त किया - यह बहुत अच्छा होगा यदि उपयोगकर्ता संकुल को सीधे साइट पर ट्रैक कर सकता है।

मालिकों को वास्तव में यह विचार पसंद आया, और डेवलपर्स में से एक ने तुरंत व्यक्तिगत खाते में प्रत्येक आइटम के लिए एक अलग बटन के साथ आंकड़े या कार्यक्षमता प्रदर्शित करने का सुझाव दिया।

यह अच्छा लग रहा था, लेकिन, उपयोगकर्ता के अनुकूल इंटरफेस का उपयोग करते हुए, वरिष्ठ डेवलपर ने तार्किक रूप से सुझाव दिया कि इस मामले में, एक उच्च संभावना है कि ग्राहक को एक साधारण जांच के लिए हर बार पासवर्ड याद रखना होगा। और यह एक चर्चा नहीं है। सब के बाद, तब उपयोगकर्ता सीधे रूसी या यूएसपीएस मेल साइटों का उपयोग करेगा।

सभी को हतोत्साहित किया गया और, पल का लाभ उठाते हुए, वही वरिष्ठ डेवलपर (अंशकालिक भी बूटस्ट्रैप-अतिसूक्ष्मवाद का एक गुप्त प्रशंसक) किसी भी उपयोगकर्ता को पंजीकृत किए बिना इस सेवा की उपलब्धता पर जोर दिया। और उन्होंने अवधारणा को एक ही बार में दो सेवाओं के लिए खोज इंजन के रूप में कार्यान्वित करने का प्रस्ताव दिया: रूसी पोस्ट और यूएसपीएस।

मुख्य डिजाइनर, अपने सहयोगी के साथ रखते हुए, एक लेकोनिक विज़ुअलाइज़ेशन का वर्णन किया - एक लाइन और एक बटन (बस ya.ru की तरह)।

इस विकल्प को सामूहिक रूप से अनुमोदित किया गया था, लेकिन विकास प्रक्रिया के दौरान पैकेज की स्थिति के लिए संदर्भ बिंदुओं की प्रणाली में सुधार करने के लिए एक और बढ़िया विचार था - जिसे अब साइट पर देखा जा सकता है। क्लाइंट, अपने पार्सल की स्थिति की जाँच करता है, पारदर्शी और समझ में आता है: "भेजा गया", "वितरण का इंतजार" और "प्राप्त" - तारीखों के साथ और अनावश्यक विवरण के बिना।

वैसे, इस सेवा के कार्यान्वयन में नौकरशाही के बिना, फिर से, यह नहीं कर सका। जैसा कि Taobao एपीआई के मामले में, हमें कार्यक्षमता को एक्सेस करने की अनुमति प्राप्त करने के लिए आधिकारिक पत्राचार में प्रवेश करना था। लेकिन हमारे शाओलिन मास्टर्स प्रबंधकों ने फिर से सोना ले लिया।

वास्तव में, मौलिक एपीआई सेवाओं के साथ कहानी हमारे लिए समाप्त हो गई, लेकिन निश्चित रूप से हम वहां नहीं रुके, और हम अब तक साइट में सुधार जारी रखते हैं (मेगाप्लान से कार्यों के बारे में याद रखें?)।

सारांशित करते हुए, हम यह जोड़ना चाहते हैं कि कार्यक्षमता के विकास के समानांतर, हम अपनी परियोजना के एक और बहुत महत्वपूर्ण घटक - ग्राहकों के साथ काम कर रहे हैं।

अंत में, एक भी कार्यक्रम जो आपको सूखा नहीं बताता है कि वितरण प्रक्रिया में एक पैकेज या अमेरिकी के लिए रूसी आकार सीमा का एक पत्राचार तालिका हमारे सुपर-अच्छा और मेगा पॉजिटिव प्रबंधकों के साथ जीवंत संवाद तक कभी नहीं पहुंच पाएगी :)

इसीलिए, हमें परिणामी सेवा पर गर्व है और आशा है कि आप इसे तकनीकी दृष्टिकोण से और उपयोगकर्ता से दोनों की सराहना करेंगे।

आपका ध्यान देने के लिए धन्यवाद
हम आपको सफल खोजों की कामना करते हैं!
Mangomag.ru