प्रस्तुत है सेमेटिक 3 एपीआई

इस संक्षिप्त पोस्ट में Semantics3 सेवा के साथ काम करने का वर्णन है, जो मुझे इंटरनेट पर खरीदारी के लिए एक निश्चित पोर्टल विकसित करने की प्रक्रिया में मिला।
सेवा का उद्देश्य दुनिया के सभी सामानों को एक जगह इकट्ठा करना है और एपीआई के माध्यम से दुकानों तक पहुंच प्रदान करना है, जहां आप मूल्य की गतिशीलता देख सकते हैं, जो क्या बेचता है, और इसी तरह (35 मिलियन से अधिक उत्पाद वर्तमान में अनुक्रमित हैं)। खरीदारी के लिए Google खोज API "सेवानिवृत्त" होने के बाद, Semantics3 तेजी से गति प्राप्त कर रहा है। वह 2013 के शीतकालीन सत्र के लिए वाई कॉम्बिनेटर फंड में सात सर्वश्रेष्ठ स्टार्टअप्स में से एक है।

शुरुआत हो रही है

सबसे पहले, आपको एपीआई का उपयोग करने के लिए एक कुंजी प्राप्त करने के लिए साइट पर उनके साथ एक खाता पंजीकृत करना होगा । फिर आप 4 में से कोई भी टैरिफ प्लान चुन सकते हैं। मैंने GitHub खाते के माध्यम से लॉग इन किया - मुझे एक एपीआई कुंजी और एक एपीआई रहस्य मिला, और प्रति दिन 1000 अनुरोधों की सीमा के साथ एक मुफ्त योजना को चुना।

एपीआई अनुरोध में 3 घटक होते हैं:
उदाहरण के लिए URL:
(https://api.semantics3.com/v1 - समापन बिंदु API
/ उत्पादों? - संसाधन
q = {"cat_id": 13658, "ब्रांड": "तोशिबा", "मॉडल": "सैटेलाइट"}) - क्वेरी पैरामीटर

एंडपॉइंट एपीआई सेवा का उपयोग करने का संस्करण है। इसे उत्पादन (https://api.semantics3.com/v1) और परीक्षण / विकास (https://api.semantics3.com/test/v1) में विभाजित किया गया है। यह प्रमाणीकरण विधि और प्रति दिन एपीआई कॉल की संख्या की सीमा से भिन्न होता है। टेस्ट के लिए, यह मूल प्रमाणीकरण (कर्ल का उपयोग करने की क्षमता) और 100 कॉल / दिन की सीमा है। उत्पादन के लिए, OAuth v1.0 2 प्रमाणीकरण और प्रतिबंध का उपयोग चयनित टैरिफ योजना के आधार पर किया जाता है।

संसाधन - API का उपयोग उत्पादों (/ उत्पादों) और श्रेणियों (/ श्रेणियों) को प्राप्त करने के लिए किया जा सकता है। सभी उत्पादों को श्रेणियों (cat_id) में व्यवस्थित किया जाता है, जिनकी पेड़ संरचना होती है -
उदाहरण के लिए, "इलेक्ट्रॉनिक्स" (कैट_आईडी 13658) श्रेणी है, जिसमें "कंप्यूटर और सहायक उपकरण" (cat_id 4992) सहित कई बाल श्रेणियां हैं, जिसमें बदले में एक बाल श्रेणी "स्कैनर्स" (cat_id 14047) शामिल है।

क्वेरी पैरामीटर - खोज क्वेरी को JSON स्ट्रिंग के रूप में व्यक्त किया जाता है। आप 50 विभिन्न क्षेत्रों का उपयोग करके बहुत लचीले प्रश्नों का निर्माण कर सकते हैं।

एपीआई पुस्तकालय

विकास के दौरान, खोज क्वेरी का परीक्षण करते समय, आप कर्ल उपयोगिता का उपयोग कर सकते हैं।

curl -G -H "api_key: SEM3E892B8487C7EA8267E1B0C8CE8345157" https://api.semantics3.com/test/v1/products --data-urlencode 'q={"cat_id":13658,"brand":"Toshiba","model":"Satellite"}' 

सामान्य तौर पर, सेमेटिक 3 ने प्रोडक्शन एपीआई तक पहुंचने के लिए कई लाइब्रेरी जारी की हैं।
पर्ल, पायथन, PHP, Node.js, रूबी, जावा और C # में कार्यान्वयन।
यहाँ एक उदाहरण है Ruby में semantics3 रत्न का उपयोग करते हुए:

  require 'rubygems' require 'semantics3' API_KEY = 'SEM3xxxxxxxxxxxxxxxxxx' API_SECRET = 'xxxxxxxxxxxxxxxxxxxxxxxx' sem3 = Semantics3::Products.new(API_KEY,API_SECRET) sem3.products_field( "cat_id", 4992 ) sem3.products_field( "brand", "Toshiba" ) productsHash = sem3.get_products puts "Results of query:\n",productsHash.to_json 

जो नेटबुक श्रेणी से शीर्ष 10 तोशिबा ब्रांड के उत्पादों की सूची वापस लाएगा। सूची को JSON प्रारूप में प्रस्तुत किया गया है, प्रत्येक उत्पाद के लिए "नाम", "मूल्य", "img" (मूल टैरिफ योजना के लिए उपलब्ध नहीं), "url" (आपूर्तिकर्ता की वेबसाइट का पता), आदि हैं। इसे वेब के रूप में प्रदर्शित किया जा सकता है। उत्पाद लिस्टिंग पृष्ठों।

खोज प्रश्नों के उदाहरण प्रलेखन में पाए जा सकते हैं।

मैं तेज और उत्तरदायी समर्थन का उल्लेख करना चाहूंगा, यहां तक ​​कि मुफ्त टैरिफ योजना के लिए भी। जब परियोजना के विकास के दौरान मेरे कुछ सवाल थे, तो सेमेटिक 3 के लोगों ने जल्दी से समाधान के साथ मदद की।