IOS एप्लिकेशन में Vkontakte.ru एपीआई के साथ काम करें

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

उदाहरण के साथ एक परियोजना github.com पर है - https://github.com/maiorov/VKAPI

वीके एपीआई विधियों पर प्रलेखन यहां पाया जा सकता है।

इस विषय पर अन्य स्रोतों से लेख:
1. appleinsider.ru
2. imaladec.net

तो, वीके एपीआई के साथ काम करने में कुछ कदम:
1. UIWebView के माध्यम से उपयोगकर्ता प्राधिकरण और accessToken'a और उपयोगकर्ता आईडी प्राप्त करना।
2. वीके एपीआई का उपयोग करना, डेटा का अनुरोध करना और प्राप्त करना:
2.1 उपयोगकर्ता की दीवार पर पाठ भेजना
२.१.१ कैप्चा
२.२ एक दीवार पर एक छवि पोस्ट करना
2.2.1 छवि अपलोड के लिए वीके सर्वर यूआरएल प्राप्त करना
२.२.२ एक POST का अनुरोध करें
2.2.3 VKontakte सर्वर पर फ़ोटो सहेजने के लिए एक अनुरोध बनाएँ
२.२.४ दीवार पर फोटो लगाएं
3. उपयोगकर्ता लॉगआउट

भाग 0. आवेदन पंजीकरण
जैसा कि यह निकला, ऑपरेशन का सबसे तुच्छ हिस्सा नहीं, इस तथ्य के कारण कि वीकेओन्कटे के पास कॉलिंग एप्लिकेशन के लिए कई रूप हैं! उचित पंजीकरण के लिए, आपको http://vkontakte.ru/editapp?act=create&site=1 लिंक का उपयोग करना होगा, आवेदन स्टैंडअलोन-एप्लिकेशन के प्रकार का चयन करें। सेटिंग्स में पैरामीटर छोड़ा जा सकता है। आपको बस एप्लिकेशन आईडी की प्रतिलिपि बनाने की आवश्यकता है। मेरे उदाहरण में, इस पैरामीटर के लिए appID का उपयोग किया जाता है।

भाग 1. प्राधिकरण
वीके एपीआई के साथ Oauth 2.0 प्रोटोकॉल का उपयोग करने के लिए, हमें accessToken और user_id की आवश्यकता है। हम UIKebView वेब ब्राउज़र के माध्यम से VK सर्वर को एक अनुरोध भेजकर इसे प्राप्त कर सकते हैं, अनुरोध के जवाब में, VKontakte सर्वर एक उपयोगकर्ता प्राधिकरण फॉर्म जारी करेगा, प्राधिकरण पारित करने के बाद हमें एक्सेसटोकन मिलेगा, user_id (उपयोगकर्ता का आईडी जिसने अपना डेटा दर्ज किया है), expires_in (टोकन वैधता समय) । ऐसा करने के लिए, एक नई परियोजना में एक दृश्य-नियंत्रक बनाएं, आइए इसे उदाहरण के लिए नाम दें vkLoginViewController। यह उपयोगकर्ता को अधिकृत करने के लिए जिम्मेदार नियंत्रक होगा, सफल प्राधिकरण होने पर, यह NSUserDefaults में प्राप्त मापदंडों को बचाएगा और प्रतिनिधि विधि को पूर्ण करेगा।

आप उदाहरण में विस्तृत कोड देख सकते हैं। यहां मैं केवल मुख्य बिंदुओं का विश्लेषण करूंगा।

नियंत्रक UIWebView * vkWebView में जोड़कर, हम एक अनुरोध करते हैं:

NSString *authLink = [NSString stringWithFormat:@"http://api.vk.com/oauth/authorize?client_id=%@&scope=wall,photos&redirect_uri=http://api.vk.com/blank.html&display=touch&response_type=token", appID]; NSURL *url = [NSURL URLWithString:authLink]; [vkWebView loadRequest:[NSURLRequest requestWithURL:url]]; 

यहां client_id आपके एप्लिकेशन, स्कोप = दीवार की आईडी है, फोटो एक्सेस अधिकार हैं जो उपयोगकर्ता से एप्लिकेशन अनुरोध (दीवार पर दीवार प्लेसमेंट, फोटो दीवार पर चित्र लगाने की आवश्यकता है)

WebViewDidFinishLoad फ़ंक्शन में, हमें VK सर्वर से प्रतिक्रिया मिलती है:

 -(void)webViewDidFinishLoad:(UIWebView *)webView { //      if ([vkWebView.request.URL.absoluteString rangeOfString:@"access_token"].location != NSNotFound) { NSString *accessToken = [self stringBetweenString:@"access_token=" andString:@"&" innerString:[[[webView request] URL] absoluteString]]; //  id ,    NSArray *userAr = [[[[webView request] URL] absoluteString] componentsSeparatedByString:@"&user_id="]; NSString *user_id = [userAr lastObject]; NSLog(@"User id: %@", user_id); if(user_id){ [[NSUserDefaults standardUserDefaults] setObject:user_id forKey:@"VKAccessUserId"]; } if(accessToken){ [[NSUserDefaults standardUserDefaults] setObject:accessToken forKey:@"VKAccessToken"]; //    .  expires_in=86400   ,     . //   ,   ,          [[NSUserDefaults standardUserDefaults] setObject:[NSDate date] forKey:@"VKAccessTokenDate"]; [[NSUserDefaults standardUserDefaults] synchronize]; } NSLog(@"vkWebView response: %@",[[[webView request] URL] absoluteString]); [(ViewController *)delegate authComplete]; [self dismissModalViewControllerAnimated:YES]; } else if ([vkWebView.request.URL.absoluteString rangeOfString:@"error"].location != NSNotFound) { NSLog(@"Error: %@", vkWebView.request.URL.absoluteString); [self dismissModalViewControllerAnimated:YES]; } } 

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

 [(ViewController *)delegate authComplete]; [self dismissModalViewControllerAnimated:YES]; 

भाग 2. एपीआई अनुरोध
अब शुरू होती है मस्ती! ViewController में उदाहरण में, मैंने कई फ़ंक्शन तैयार किए हैं जिनके द्वारा आप समझ सकते हैं कि एपीआई के साथ कैसे काम किया जाए।

2.1 उपयोगकर्ता की दीवार पर पाठ भेजना
उदाहरण के लिए, दीवार पर पाठ भेजने का कार्य:

 - (void) sendText { NSString *user_id = [[NSUserDefaults standardUserDefaults] objectForKey:@"VKAccessUserId"]; NSString *accessToken = [[NSUserDefaults standardUserDefaults] objectForKey:@"VKAccessToken"]; NSString *text = @"   API !"; //        NSString *sendTextMessage = [NSString stringWithFormat:@"https://api.vk.com/method/wall.post?owner_id=%@&access_token=%@&message=%@", user_id, accessToken, [self URLEncodedString:text]]; NSLog(@"sendTextMessage: %@", sendTextMessage); //            NSDictionary *result = [self sendRequest:sendTextMessage withCaptcha:NO]; //       NSString *errorMsg = [[result objectForKey:@"error"] objectForKey:@"error_msg"]; if(errorMsg) { [self sendFailedWithError:errorMsg]; } else { [self sendSuccessWithMessage:@"   !"]; } } 

सादगी के लिए, मैं NSUserDefaults में डेटा संग्रहीत करता हूं। प्राधिकरण पूरा हो गया है, जिसका अर्थ है कि हमारे पास अनुरोध करने के लिए हमारे पास सब कुछ है। Wall.post विधि का उपयोग करते हुए , हम उपयोगकर्ता आईडी (मालिक_ आईडी) और टोकन (एक्सेस_टोकन) पास करते हैं, हम पहले URLEncodedString फ़ंक्शन के माध्यम से संदेश पैरामीटर के लिए पाठ संदेश चलाते हैं:

 //         - (NSString *)URLEncodedString:(NSString *)str { NSString *result = (NSString *)CFURLCreateStringByAddingPercentEscapes(kCFAllocatorDefault, (CFStringRef)str, NULL, CFSTR("!*'();:@&=+$,/?%#[]"), kCFStringEncodingUTF8); [result autorelease]; return result; } 

अनुरोध तैयार करने के बाद, हमें फ़ंक्शन का उपयोग करके इसे सर्वर पर भेजना होगा:

 [self sendRequest:sendTextAndLinkMessage withCaptcha:NO]; 

जैसा कि आप देख सकते हैं, फ़ंक्शन withCaptcha पैरामीटर को स्वीकार करता है: (BOOL) हमें इसकी आवश्यकता होगी यदि सर्वर को कार्रवाई की पुष्टि करने के लिए कैप्चा दर्ज करने की आवश्यकता होती है। चूंकि अभी तक किसी कैप्चा की आवश्यकता नहीं है, इसलिए हम NO को स्थानांतरित करते हैं।

दरअसल, फंक्शन भेजने का अनुरोध स्वयं:

 - (NSDictionary *) sendRequest:(NSString *)reqURl withCaptcha:(BOOL)captcha { //      ,      captcha_sid  captcha_key if(captcha == YES){ NSString *captcha_sid = [[NSUserDefaults standardUserDefaults] objectForKey:@"captcha_sid"]; NSString *captcha_user = [[NSUserDefaults standardUserDefaults] objectForKey:@"captcha_user"]; //      .  ,      . reqURl = [reqURl stringByAppendingFormat:@"&captcha_sid=%@&captcha_key=%@", captcha_sid, [self URLEncodedString: captcha_user]]; } NSLog(@"Sending request: %@", reqURl); NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:reqURl] cachePolicy:NSURLRequestReloadIgnoringLocalCacheData timeoutInterval:60.0]; //      NSURLConnection,     NSData NSData *responseData = [NSURLConnection sendSynchronousRequest:request returningResponse:nil error:nil]; //    ,        JSONKit  NSDictionary if(responseData){ NSDictionary *dict = [[JSONDecoder decoder] parseJSONData:responseData]; //       NSString *errorMsg = [[dict objectForKey:@"error"] objectForKey:@"error_msg"]; NSLog(@"Server response: %@ \nError: %@", dict, errorMsg); //    .      Captcha needed,     . if([errorMsg isEqualToString:@"Captcha needed"]){ isCaptcha = YES; //     NSString *captcha_sid = [[dict objectForKey:@"error"] objectForKey:@"captcha_sid"]; NSString *captcha_img = [[dict objectForKey:@"error"] objectForKey:@"captcha_img"]; [[NSUserDefaults standardUserDefaults] setObject:captcha_img forKey:@"captcha_img"]; [[NSUserDefaults standardUserDefaults] setObject:captcha_sid forKey:@"captcha_sid"]; //  url         [[NSUserDefaults standardUserDefaults] setObject:reqURl forKey:@"request"]; [[NSUserDefaults standardUserDefaults] synchronize]; [self getCaptcha]; } return dict; } return nil; } 

फ़ंक्शन सर्वर से NS Shadow की प्रतिक्रिया देता है; JSONKit का उपयोग इसे जेनरेट करने के लिए किया जाता है, क्योंकि डिफ़ॉल्ट रूप से JSON प्रारूप में VKontakte प्रतिसाद देता है।

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

 [self getCaptcha]; 

आइए इसे और अधिक विस्तार से विचार करें:

 - (void) getCaptcha { NSString *captcha_img = [[NSUserDefaults standardUserDefaults] objectForKey:@"captcha_img"]; UIAlertView *myAlertView = [[UIAlertView alloc] initWithTitle:@" :\n\n\n\n\n" message:@"\n" delegate:self cancelButtonTitle:@"Cancel" otherButtonTitles:@"OK", nil]; UIImageView *imageView = [[[UIImageView alloc] initWithFrame:CGRectMake(12.0, 45.0, 130.0, 50.0)] autorelease]; imageView.image = [UIImage imageWithData:[NSData dataWithContentsOfURL:[NSURL URLWithString:captcha_img]]]; [myAlertView addSubview:imageView]; UITextField *myTextField = [[[UITextField alloc] initWithFrame:CGRectMake(12.0, 110.0, 260.0, 25.0)] autorelease]; [myTextField setBackgroundColor:[UIColor whiteColor]]; //   myTextField.autocorrectionType = UITextAutocorrectionTypeNo; //   myTextField.autocapitalizationType = UITextAutocapitalizationTypeNone; myTextField.tag = 33; [myAlertView addSubview:myTextField]; [myAlertView show]; [myAlertView release]; } - (void)alertView:(UIAlertView *)actionSheet clickedButtonAtIndex:(NSInteger)buttonIndex { if(isCaptcha && buttonIndex == 1){ isCaptcha = NO; UITextField *myTextField = (UITextField *)[actionSheet viewWithTag:33]; [[NSUserDefaults standardUserDefaults] setObject:myTextField.text forKey:@"captcha_user"]; NSLog(@"Captcha entered: %@",myTextField.text); //           NSString *request = [[NSUserDefaults standardUserDefaults] objectForKey:@"request"]; NSDictionary *newRequestDict =[self sendRequest:request withCaptcha:YES]; NSString *errorMsg = [[newRequestDict objectForKey:@"error"] objectForKey:@"error_msg"]; if(errorMsg) { [self sendFailedWithError:errorMsg]; } else { [self sendSuccessWithMessage:@"     !"]; } } } 

UIImageView और UITextField और captcha_img पैरामीटर के अतिरिक्त के साथ, मानक UIAlertView का उपयोग करके, हम उपयोगकर्ता को कैप्चा दर्ज करने का अवसर देते हैं। कैप्चा दर्ज किए जाने के बाद, UIAlertView प्रतिनिधि समारोह में, कैप्चा_यूज़र कुंजी के साथ NSUserDefaults में दर्ज किए गए उपयोगकर्ता को सहेजें और पहले से सहेजे गए अनुरोध url का उपयोग करते हुए, इसे फिर से करें, इस बार पैरामीटर में Captcha: YES निर्दिष्ट करें। परिणामस्वरूप, अनुरोध भेजने से पहले, इसमें कैप्चा_सिड और कैप्चा_की पैरामीटर जोड़े जाते हैं (उपयोगकर्ता ने क्या दर्ज किया है):

 - (NSDictionary *) sendRequest:(NSString *)reqURl withCaptcha:(BOOL)captcha { //      ,      captcha_sid  captcha_key if(captcha == YES){ NSString *captcha_sid = [[NSUserDefaults standardUserDefaults] objectForKey:@"captcha_sid"]; NSString *captcha_user = [[NSUserDefaults standardUserDefaults] objectForKey:@"captcha_user"]; //      .  ,      . reqURl = [reqURl stringByAppendingFormat:@"&captcha_sid=%@&captcha_key=%@", captcha_sid, [self URLEncodedString: captcha_user]]; } ... 

कैप्चा दर्ज किया गया, अनुरोध भेजा गया, पाठ को उपयोगकर्ता की दीवार पर सफलतापूर्वक पोस्ट किया जाना चाहिए!

२.२ एक दीवार पर एक छवि पोस्ट करना
अक्सर उपयोगकर्ता की दीवार पर एप्लिकेशन से एक फोटो लगाने की आवश्यकता होती है। इस समस्या को हल करने के लिए आपको निम्न चरणों से गुजरना होगा:

1. हमारी छवि डाउनलोड करने के लिए VKontakte सर्वर के url का अनुरोध करें ( photos.getWallUploadServer )
2. सर्वर की प्रतिक्रिया में प्राप्त लिंक का उपयोग करते हुए, हम POST विधि का उपयोग करके छवि भेजते हैं
3. प्रतिक्रिया हैश, फोटो, सर्वर को प्राप्त करने के बाद, हम दीवार पर फोटो को बचाने के लिए एक कमांड भेजेंगे (फोटो। saveWallPhoto )
4. प्रतिक्रिया में एक फोटो आईडी प्राप्त करने के बाद, हम दीवार पर एक तस्वीर पोस्ट करने का अनुरोध करते हैं।

2.2.1 छवि अपलोड के लिए वीके सर्वर यूआरएल प्राप्त करना

 - (IBAction)sendImageAction:(id)sender { if(!isAuth) return; UIImage *image = [UIImage imageNamed:@"test.jpg"]; NSString *user_id = [[NSUserDefaults standardUserDefaults] objectForKey:@"VKAccessUserId"]; NSString *accessToken = [[NSUserDefaults standardUserDefaults] objectForKey:@"VKAccessToken"]; //  1 NSString *getWallUploadServer = [NSString stringWithFormat:@"https://api.vk.com/method/photos.getWallUploadServer?owner_id=%@&access_token=%@", user_id, accessToken]; NSDictionary *uploadServer = [self sendRequest:getWallUploadServer withCaptcha:NO]; //      NSString *upload_url = [[uploadServer objectForKey:@"response"] objectForKey:@"upload_url"]; ... 

अब, छवि डाउनलोड करने के लिए लिंक प्राप्त करने के बाद, हमें संलग्न छवि के साथ एक POST अनुरोध करने की आवश्यकता है। ऐसा करने के लिए, छवि को NSData में रूपांतरित करें और फ़ंक्शन का उपयोग करके अनुरोध बनाएं

 [self sendPOSTRequest:upload_url withImageData:imageData]; 

२.२.२ एक POST का अनुरोध करें

 ... //  2 //    NSData NSData *imageData = UIImageJPEGRepresentation(image, 1.0f); NSDictionary *postDictionary = [self sendPOSTRequest:upload_url withImageData:imageData]; //     hash, photo, server NSString *hash = [postDictionary objectForKey:@"hash"]; NSString *photo = [postDictionary objectForKey:@"photo"]; NSString *server = [postDictionary objectForKey:@"server"]; ... 

आप उदाहरण में POST अनुरोध बनाने वाले फ़ंक्शन को देख सकते हैं।

2.2.3 VKontakte सर्वर पर फ़ोटो सहेजने के लिए एक अनुरोध बनाएँ

 ... //  3 //        ,    id  NSString *saveWallPhoto = [NSString stringWithFormat:@"https://api.vk.com/method/photos.saveWallPhoto?owner_id=%@&access_token=%@&server=%@&photo=%@&hash=%@", user_id, accessToken,server,photo,hash]; NSDictionary *saveWallPhotoDict = [self sendRequest:saveWallPhoto withCaptcha:NO]; NSDictionary *photoDict = [[saveWallPhotoDict objectForKey:@"response"] lastObject]; NSString *photoId = [photoDict objectForKey:@"id"]; ... 

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

२.२.४ दीवार पर फोटो लगाएं

 ... //  4 //      NSString *postToWallLink = [NSString stringWithFormat:@"https://api.vk.com/method/wall.post?owner_id=%@&access_token=%@&message=%@&attachment=%@", user_id, accessToken, [self URLEncodedString:@"      "], photoId]; NSDictionary *postToWallDict = [self sendRequest:postToWallLink withCaptcha:NO]; NSString *errorMsg = [[postToWallDict objectForKey:@"error"] objectForKey:@"error_msg"]; if(errorMsg) { [self sendFailedWithError:errorMsg]; } else { [self sendSuccessWithMessage:@"   !"]; } // !     ! 

भाग 3. उपयोगकर्ता लॉगआउट
लॉगआउट करने के लिए, बस VKontakte सर्वर को एक अनुरोध भेजें:

 NSString *logout = @"http://api.vk.com/oauth/logout"; 

उदाहरण लॉगआउट फ़ंक्शन:

 - (IBAction)logout:(id)sender { //   logout NSString *logout = @"http://api.vk.com/oauth/logout"; NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:logout] cachePolicy:NSURLRequestReloadIgnoringLocalCacheData timeoutInterval:60.0]; NSData *responseData = [NSURLConnection sendSynchronousRequest:request returningResponse:nil error:nil]; if(responseData){ NSDictionary *dict = [[JSONDecoder decoder] parseJSONData:responseData]; NSLog(@"Logout: %@", dict); //    ,    isAuth = NO; [[NSUserDefaults standardUserDefaults] removeObjectForKey:@"VKAccessUserId"]; [[NSUserDefaults standardUserDefaults] removeObjectForKey:@"VKAccessToken"]; [[NSUserDefaults standardUserDefaults] removeObjectForKey:@"VKAccessTokenDate"]; [[NSUserDefaults standardUserDefaults] synchronize]; [self sendSuccessWithMessage:@"  !"]; } } 

इस तथ्य के बावजूद कि VKontakte एक त्रुटि के साथ जवाब देता है, उपयोगकर्ता अभी भी बाहर निकलता है :)

 Logout: { error = "invalid_client"; "error_description" = "client_id is incorrect"; } 

निष्कर्ष
मुझे उम्मीद है कि यह लेख आपको Vkontakte API सीखने में मदद करता है। मुझे टिप्पणी, परिवर्धन की खुशी होगी।