नया हेडहंटर एपीआई और एपीआई 1.0 डिप्रेसेशन

कुछ लोगों को पता है कि हमारे पास एक एपीआई है, एक प्रोग्राम इंटरफ़ेस है जो मोबाइल और डेस्कटॉप एप्लिकेशन, अन्य साइटों और सिर्फ विगेट्स की अनुमति देता है, जिसमें हमारे ब्लॉग पेज पर इस लेख के दाईं ओर स्थित hh.ru प्लेटफॉर्म के साथ "संचार" करना शामिल है।

हमें यह घोषणा करते हुए खुशी हो रही है कि वर्तमान कार्यान्वयन को एपीआई के एक नए, पूरी तरह से नए संस्करण द्वारा प्रतिस्थापित किया जा रहा है।

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

कार्यक्षमता पर ध्यान केंद्रित करने के लिए, हमने एक्सएमएल संस्करण को छोड़ दिया, विधियों के नामों को समायोजित किया और उन्हें उपयोगकर्ता से निम्न-स्तरीय क्षणों को छिपाते हुए तार्किक संस्थाओं में वर्गीकृत किया। परिणाम एक नया HTTP REST JSON API है। जैसे ही हमने पिछले संस्करण की कार्यक्षमता के दायरे में कदम रखा है, हम इसे आधिकारिक रूप से खोलते हैं।

नए संस्करण में, हमने वर्जनिंग को छोड़ दिया: अब एपीआई वर्धित रूप से बढ़ेगा, पिछड़े संगतता के लिए पूर्ण समर्थन के साथ। धीरे-धीरे, सभी hh.ru कार्यक्षमता को कवर किया जाएगा। उपयोगकर्ता खाते का उपयोग करके तृतीय-पक्ष एप्लिकेशन में प्राधिकरण पहले से ही उपलब्ध है। ऐसा करने के लिए, हम OAuth2 प्रोटोकॉल का उपयोग करते हैं, जो आपको अपने उपयोगकर्ता नाम / पासवर्ड को तीसरे पक्ष के अनुप्रयोगों को प्रकट किए बिना उपयोगकर्ता के व्यक्तिगत डेटा तक पहुंच प्रदान करने की अनुमति देता है। इसके अलावा, अब डेवलपर्स अधिकृत जॉबसेकर के रिज्यूमे की सूची तक पहुंच सकते हैं, रिक्तियों और "चयनित रिक्तियों" के लिए उन्नत खोज का उपयोग कर सकते हैं। धीरे-धीरे, आवेदक की लापता सेवाएं बाहर आ जाएंगी: रिज्यूमे बनाना / संपादित करना, रिक्तियों के लिए ऑटो-खोज। उसके बाद, नियोक्ताओं के लिए कार्यक्षमता दिखाई देगी: रिज्यूमे की खोज, रिक्तियों का प्रकाशन और बहुत कुछ।

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

पहला संस्करण ( http://api.hh.ru ) कम से कम 3 और महीनों के लिए उपलब्ध होगा, इस दौरान डेवलपर्स को अपने अनुप्रयोगों को नए संस्करण में स्थानांतरित करना होगा। गिरावट में, अस्थायी आउटेज शुरू हो जाएगा और एपीआई 1.0 के बंद होने की सही तारीख की सूचना दी जाएगी।

प्रलेखन और नए एपीआई के बारे में अधिक जानकारी https://github.com/hhru/api पर स्थित है। समस्याओं का एक भाग भी है जहां आप किसी भी सुधार की पेशकश कर सकते हैं, संशोधन के लिए अनुरोध छोड़ सकते हैं या समस्या की रिपोर्ट कर सकते हैं। आप ट्विटर के माध्यम से सीधे डेवलपर्स से भी संपर्क कर सकते हैं: @apihhru ।