Yandex.Money एपीआई और एक डेमो एंड्रॉइड एप्लिकेशन के साथ काम करने के लिए लाइब्रेरी

शुभ दोपहर, आवास।

मैं Yandex.Money एपीआई के साथ काम करने के लिए अपने विकास - एंड्रॉइड लाइब्रेरी को साझा करना चाहता हूं।

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

नतीजतन, पुस्तकालय और एपीआई के माध्यम से बटुए के साथ काम करने वाले एंड्रॉइड के लिए डेमो एप्लिकेशन को धोया गया था।

दरअसल, एंड्रॉइड एप्लिकेशन के बारे में लाइब्रेरी का आधार OAuthActivity क्लास है, जहां से आपकी एक्टिविटी विरासत में मिलनी चाहिए, जो एप्लिकेशन के शुरुआती OAuth ऑथराइजेशन को परफॉर्म करेगी। एप्लिकेशन प्राधिकरण का परिणाम एक एक्सेस टोकन है, जिसकी मदद से YandexMoneyService क्लास को आरंभीकृत किया जाता है, जो इस टोकन का उपयोग करते हुए, निम्न क्रियाएं (अभी के लिए) कर सकता है

• getAccountInfo: अनुरोध खाता जानकारी - एपीआई विधि खाता-जानकारी
• getOperationHistory: संचालन के इतिहास का वर्णन करता है - API विधि ऑपरेशन-इतिहास

जब तर्क के बिना कहा जाता है, तो दूसरी विधि सभी संचालन (क्रेडिट और शुल्क दोनों) लौटाती है। पेजिंग अभी समर्थित नहीं है। एक विशिष्ट ऑपरेशन को इंगित करने के लिए एक तर्क के रूप में वर्ग YandexMoneyOperationTypes के ऑब्जेक्ट को पास करना संभव है।

ब्लिस्टर लाइब्रेरी में एक टोकन स्टोर भी है। हर बार प्राधिकरण से अनुरोध नहीं करने के लिए, टोकन को बचाया जा सकता है। इसके लिए, AccessTokenStorage वर्ग के वारिसों का उपयोग किया जाता है, जिसका नाम है SharedPreferencesStorage और EncryptedSodedPreferencesStorage । दूसरा कार्यान्वयन इस बात में भिन्न है कि यह टोकन को 3DES एन्क्रिप्टेड रूप में संग्रहीत करता है।

OAuth प्रमाणीकरण का उपयोग करने के लिए, एक एप्लिकेशन को निम्नलिखित विधियों को लागू करके OAuthActivity वंशज वर्ग को परिभाषित करना चाहिए:

• getRequiredPims एक ऐसा तरीका है जो एप्लिकेशन द्वारा आवश्यक अधिकारों के सेट को लौटाता है। Yandex.Money के लिए, YandexMoneyPmail कंटेनर का उपयोग करें
• getClientId - Yandex.Money सिस्टम में क्लाइंट पहचानकर्ता। यह आवेदन पंजीकरण चरण में जारी किया जाएगा ।
• getAppId - एप्लिकेशन पहचानकर्ता। एक रीडायरेक्ट_यूरी पते को संकलित करने के लिए उपयोग किया जाता है, यह वास्तव में एक प्राधिकरण प्रतिक्रिया को संसाधित करते समय एप्लिकेशन की पहचान करता है, इसे सेट करना बेहतर होता है = एप्लिकेशन पैकेज का नाम
• getServer - सर्वर से प्राधिकरण का अनुरोध करने के लिए
• getTokenStorage - प्राप्त प्राधिकरण टोकन को संग्रहीत करने के लिए उपयोग किया जाने वाला टोकन स्टोर लौटाता है

प्राधिकरण == “en.elifantiev.yandex.oauth.AUTH_RESULT” को भेजकर गतिविधि शुरू करने से प्राधिकरण की सफलता या विफलता की सूचना दी जाती है (देखें OAuthActivity.ACTION_AUTH_RESULT)। इरादे एक सफलता का झंडा (.AUTH_RESULT_EXTRA) AUTH_RESULT_OK या AUTH_RESULT_ERROR के बराबर है। त्रुटि अतिरिक्त .EXTRA_AUTH_RESULT_ERROR में स्थित है।

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

<intent-filter> <action android:name="android.intent.action.VIEW"/> <category android:name="android.intent.category.DEFAULT"/> <category android:name="android.intent.category.BROWSABLE"/> <data android:scheme="oauth" android:host="@string/app_id"/> </intent-filter> 

वास्तव में, यह ब्राउज़र को URL oauth पर पुनर्निर्देशित करने की प्रक्रिया है: // appId (जहां appId अनुप्रयोग पहचानकर्ता है, getAppId विधि के समान है, मैंने इसे एप्लिकेशन संसाधनों में सहेजा है)।

डेमो ऐप के बारे में ...

इसमें 3 गतिविधियाँ शामिल हैं - AppLoginActivity , AuthActivity और MainActivity ।

अनुप्रयोग प्राधिकरण प्रक्रिया के माध्यम से जाने के लिए आवेदन की पहली शुरुआत में AppLoginActivity (प्रामाणिकता लॉन्च करता है, जो बदले में OAuthActivity का उत्तराधिकारी है)। यदि एप्लिकेशन पहले ही सफलतापूर्वक प्राधिकरण पारित कर चुका है, तो पिन कोड अनुरोध संवाद प्रदर्शित होता है।

प्राधिकरण प्रक्रिया से गुजरने से पहले, प्रामाणिकता उपयोगकर्ता से एक नया पिन कोड मांगती है, जिसे बाद में एन्क्रिप्टेड टोकन को स्टोर करने के लिए उपयोग किया जाएगा, और फिर प्राधिकरण शुरू होता है।

प्राधिकरण परिणाम AppLoginActivity पर वापस आता है जहां इसे संसाधित किया जाता है (एक त्रुटि संदेश प्रदर्शित होता है या राज्य सहेजा जाता है - प्राधिकरण पूरा हो गया है)। सफल होने पर, MainAcitivty लॉन्च किया जाता है, जो एक सेवा कॉल लॉन्च करता है।

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

PS लेखक का Yandex और Yandex.Money से कोई लेना-देना नहीं है।
EDIT एक कुंजी के रूप में पड़ा हुआ है, आवेदन शुरू नहीं होगा। एक वैकल्पिक पुनर्निर्देशन पते के साथ अपना आवेदन पंजीकृत करें और अपना पहचानकर्ता प्राप्त करें।