Vkontakte API का उपयोग करने का सही तरीका

हेलो, हेब्र!



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

बस्तियों के नीचे जलते हुए विवरण और दृष्टिकोण।





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



आरक्षण करने के लिए तुरंत आवश्यक है, विवरण के अलावा, मैं अपने पुस्तकालय में काम करने वाले कोड के टुकड़े लाऊंगा, एक लिंक जिसे मैं लेख के अंत में प्रदान करूंगा। पुस्तकालय नवीनतम स्थिर संस्करण 5.5 पर काम करता है, यदि आप जनरेटर को बैच रसीद से काटते हैं, तो इसे 5.4 पर काम करना चाहिए।



आइए शुरुआत करें कि हम प्राधिकरण के माध्यम से कैसे जा सकते हैं।

एक्सेस टोकन प्राप्त करने के संदर्भ में (एक्सेस टोकन), हम इसे तीन तरीकों से कर सकते हैं :

• सर्वर प्राधिकरण (तथाकथित साइट प्राधिकरण)
• ग्राहक प्राधिकरण (स्टैंडअलोन)
• अनुप्रयोग सर्वर प्राधिकरण

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



पहले मामले में रसीद एल्गोरिथ्म निम्न बिंदुओं की पूर्ति के लिए कम है:

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

नमूना कोड जिसके साथ आप इसे क्रैंक कर सकते हैं यह एक मुश्किल व्यवसाय नहीं है।

$auth = getjump\Vk\Auth::getInstance(); $auth->setAppId('3470411')->setScope('SCOPE')->setSecret('SECRET CODE')->setRedirectUri('http://localhost/test.php'); $token=$auth->startCallback(); printf("<a href='%s' target='_top'>LINK</a>", $auth->getUrl());
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

यह माना जाता है कि हमारा डोमेन लोकलहोस्ट है, और वर्तमान फ़ाइल test.php है। यदि सब कुछ ठीक रहा, तो हमारे $ टोकन वेरिएबल में प्राधिकरण पारित करने वाले उपयोगकर्ता की पहुंच कुंजी होगी।



जिस क्षण से हमारे पास पहुंच कुंजी है, हम एपीआई अनुरोधों को निष्पादित कर सकते हैं । अनुरोधों का सामान्य तर्क सरल है, आप URL API के लिए विशेष रूप से गठित अनुरोध पास करते हैं। अनुरोध में विधि और तर्कों का नाम होना चाहिए।

api.vk.com/method/METHOD_NAME?PARAMETERS&access_token=ACCESS_TOKEN

विधियों की सूची , यह समृद्ध चीजों में से एक है एपीआई। इसमें आप उन तरीकों को पा सकते हैं जिनके लिए उनके काम के लिए एक्सेस कुंजी की आवश्यकता नहीं होती है, इसलिए आप उन्हें प्राप्त किए बिना कॉल कर सकते हैं।



पुस्तकालय का उपयोग करते समय, हमें एक मूल वस्तु बनाने की जरूरत है, उदाहरण के लिए इस तरह:

 $vk = getjump\Vk\Core::getInstance()->apiVersion('5.5')->setToken($token);
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

पुस्तकालय का उपयोग कर नमूना प्रश्नों का एक जोड़ा:



प्रत्येक में एक अनाम फ़ंक्शन के माध्यम से, ठीक 100 ऑब्जेक्ट्स पास होंगे, जिसमें उपयोगकर्ता डेटा 1 से 100 तक होगा। ध्यान दें कि यदि हम फ़ंक्शन कॉल को हटा देते हैं, तो कोई अनुरोध नहीं होगा, सभी क्योंकि कोई ऑब्जेक्ट वापस कर दिया जाएगा जिसमें __call और __get जादू विधियों को फिर से परिभाषित किया गया है, जो हमें एक अनुरोध करने की अनुमति देता है जब हमें वास्तव में इसकी आवश्यकता होती है।

 $vk->request('users.get', ['user_ids' => range(1, 100)])->each(function($i, $v) { if($v->last_name == '') return; print $v->last_name . '<br>'; });
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

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

 foreach($vk->request('messages.get')->batch(100) as $data) { $data->each(function($i, $m) { if(isset($m->body)) print $m->body . PHP_EOL; }); }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

एपीआई में पाया जा सकता है कि एक अच्छा तरीका निष्पादन है । यह कोड पैरामीटर को एक तर्क के रूप में लेता है, कोड एक प्रकार का छद्म जावास्क्रिप्ट है जो हमें सर्वर साइड पर हमारे कोड को निष्पादित करने की अनुमति देता है, यह आपको संग्रहीत प्रक्रियाओं को निष्पादित करने की भी अनुमति देता है जो हम अपने आवेदन को संपादित करते समय बना सकते हैं।



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

 $js1 = $vk->request('messages.get', ['count' => 200, 'offset' =>0 * 200])->toJs(); //    VkJs $js2 = $vk->request('messages.get', ['count' => 200, 'offset' =>1 * 200])->toJs(); $js3 = $vk->request('messages.get', ['count' => 200, 'offset' =>2 * 200])->toJs(); $js4 = $vk->request('messages.get', ['count' => 200, 'offset' =>3 * 200])->toJs(); $js1 ->append($js2) //   js2  js1 ->append($js3) ->append($js4) ->execute() //    (     RequestTransaction) ->response //    ->each( function($i, $v) //           execute(  4 , 4 ) { $v->each(function($c, $d) { //     200     if(isset($d->body)) print $d->body; //      }); });
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

जैसा कि वादा किया गया था, उन गलतफहमियों में से एक जिन्हें आप एपीआई (5.21) के वर्तमान संस्करण में सामना कर सकते हैं, users.get विधि हमें एक प्रतिक्रिया देगी, एक सरणी की तरह, हालांकि अन्य स्थानों में, उदाहरण के लिए, friends.get , संस्करण 5 से शुरू होकर, हम वापस आ गए हैं। फ़ील्ड गिनती और आइटम, यह मुझे लगता है कि यह पूरी तरह से तार्किक नहीं है, इसके अलावा एपीआई के साथ काम करते समय अतिरिक्त कोड की आवश्यकता होती है।



पुस्तकालय में कुछ कार्यों के लिए हैंडलर भी हैं, आपकी मदद से और भी कुछ हो सकता है।

पुस्तकालय का उपयोग करके, हम बहुत अच्छा और सुंदर कोड प्राप्त कर सकते हैं, और यह हमारे कठिन व्यवसाय में सबसे महत्वपूर्ण बात है।

यह संभावना है कि कोड में कुछ गलतफहमी या कीड़े थे, मुझे आपके ध्यान की उम्मीद है और पुल अनुरोधों का स्वागत है।

अधिकांश भाग के लिए पुस्तकालय PSR-0 मानक से मिलता है।



मुझे आशा है कि मैं आपको यह दिखाने में सक्षम था कि Vkontakte API डरावना नहीं है, लेकिन यह भी सुखद है।



आपका ध्यान के लिए धन्यवाद!



जीथब से लिंक: github.com/getjump/VkApiPHP

व्यापक एपीआई गाइड : vk.com/dev/main

PSR-0: github.com/getjump/fig-standards/blob/master/accepted/PSR-0.md

पैकगिस्ट: packagist.org/packages/getjump/vk



अद्यतन:

संगीतकार के माध्यम से स्थापित किया जा सकता है: composer require "getjump/vk:*"







अद्यतन 2:

अब न्यूनतम संस्करण 5.4 है, सैद्धांतिक रूप से (सिद्धांत में इसकी अधिकांश कार्यक्षमता का उपयोग नहीं किया जाता है) यह 5.3 तक शुरू हो सकता है, यदि आप सरणियों के लिए लघु वाक्यविन्यास का उपयोग नहीं करते हैं।