Yandex.Money एपीआई के साथ काम करने के लिए PHP पुस्तकालय

मैं लंबे समय से कुछ नया करने की कोशिश करना चाहता था, और अब, जब काम पर उन्होंने विभिन्न भाषाओं में Yandex.Money API का उपयोग करने के उदाहरण लिखने का सुझाव दिया, तो मैंने इस चुनौती की पेशकश को सहर्ष स्वीकार कर लिया। चूंकि विभिन्न होस्टिंग साइटों पर अनुप्रयोगों में सबसे अधिक बार इस तरह की कार्यक्षमता का उपयोग किया जाता है, इसलिए PHP में इसे लिखने का प्रयास करने के लिए एक मजबूत इच्छाशक्ति वाला निर्णय लिया गया था। इसके अलावा, इससे पहले एपीआई मैं भी नहीं देखा है; इसके अलावा, विश्वविद्यालय में प्रयोगशाला को छोड़कर, मुझे PHP के साथ कोई अनुभव नहीं था। मामला दिलचस्प होने का वादा किया।

पर्यावरण की पसंद

पहली बात जो मुझे पता चली: होस्टिंग को तुरंत विकसित करना और तैनात करना बहुत सुविधाजनक नहीं है। और मैंने वेब डेवलपर के लिए कुछ सज्जन किट डाउनलोड करने का फैसला किया। छात्र दिनों से, डेनेवर नाम स्मृति में लूम हो गया। मैंने इसकी कोशिश की, लेकिन जल्दी से इसे मना कर दिया। वह अपनी खुद की एक ज़िंदगी जीता है, और जब मैंने अपाचे गोपनीय फ़ाइल में कुछ लिखकर इसे कॉन्फ़िगर करने का प्रयास किया, तो उसने अपने विवेक पर इसे मिटा दिया या मिटा नहीं दिया, सब कुछ हाथ से कॉन्फ़िगर करने की अनुमति नहीं दी। यही है, यह पता चला है कि मैंने इसे कॉन्फ़िगर नहीं किया, लेकिन उसने मुझे किया। याद दिलाया "अगर मेरे पास एक घोड़ा था - यह एक नंबर होगा ..."। नतीजतन, मैं, निश्चित रूप से, उसे हरा दिया, लेकिन एक सरल WAMP- सर्वर खोजने का फैसला किया। मैं यह नोट करना चाहता हूं कि डेनवर एक अच्छा उत्पाद है और मेरे पास इसके खिलाफ कुछ भी नहीं है, लेकिन मैं फैक्स और मैनुअल को पढ़ना नहीं चाहता था।

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

OAuth प्रमाणीकरण

मैंने निर्देश पढ़े, प्रलेखन डाउनलोड किया, कृपाण को उजागर किया और युद्ध में भाग गया। लेकिन लड़ाई में, मुझे OAuth प्रमाणीकरण द्वारा जल्दी से हरा दिया गया था। OAuth एक उपयोगकर्ता की सेवा / खाते में प्रवेश करने और उनके आवेदन में उनके उपयोगकर्ता नाम और पासवर्ड को संग्रहीत किए बिना एक्सेस करने का एक तरीका है। यह ट्विटर के निर्माता से हमारे पास आया और कुछ इस तरह दिखता है: हम सेवा के लिए एक अनुरोध करते हैं (हमारे मामले में, Yandex.Money), उपयोगकर्ता Yandex.Money सर्वर पर अपना उपयोगकर्ता नाम / पासवर्ड दर्ज करता है और हमारे आवेदन को अपने खाते का उपयोग करने की अनुमति देता है। उसके बाद, Yandex.Money सर्वर हमारे एप्लिकेशन पर रीडायरेक्ट करता है, और हमें एक अस्थायी कोड मिलता है, जिसका जीवनकाल बहुत कम होता है। फिर, Yandex.Money के लिए एक अन्य अनुरोध के माध्यम से, हम इस बार कोड को उपयोगकर्ता के निरंतर टोकन में बदलते हैं और फिर हमारे लिए, एक डीमोबिलेशन के रूप में, सभी सड़कें खुली हैं।

हालाँकि, जब मैं OAuth प्रमाणीकरण से गुजरा, तो मुझे एक सुरक्षा समस्या आई। मैंने Yandex.Money सर्वर तक पहुंचने का प्रयास किया, लेकिन PHP ने गंदे को शपथ दिलानी शुरू कर दी और प्रमाणपत्रों के बारे में कुछ कहा। मैंने इंटरनेट पर थोड़ा सा परिमार्जन किया और महसूस किया कि सर्वर के एसएसएल प्रमाणपत्र की जांच के लिए हमारे आवेदन के लिए यह आवश्यक था। मैं उपयोगकर्ताओं की सुरक्षा की गारंटी देना चाहता था, और मैंने खोज जारी रखी। लेकिन RuNet में सर्वर सर्टिफिकेट सत्यापन के कार्यान्वयन के लगभग कोई उदाहरण नहीं हैं। मैं आपको क्रम से बताऊंगा।

अनुरोध भेजने पर सबसे पहले, आपको कोड में प्रमाणपत्र सत्यापन पंजीकृत करना होगा। प्रमाणपत्र सत्यापन अनुरोध भेजने के लिए CURL का उपयोग कैसे करें? मैंने खोजना शुरू किया और आश्चर्यचकित हुआ कि प्रमाणपत्र त्रुटियों के लिए सबसे लोकप्रिय सलाह: अक्षम सत्यापन। और यह साइटों और मंचों (उदाहरण के लिए, यहां ) के एक समूह पर पेश किया जाता है। सामान्य रूप से डरावना। यहाँ वह कोड है जो सबसे अधिक बार पेश किया जाता है:

curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

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

फिर घर पर Yandex.Money सार्वजनिक प्रमाण पत्र रखना आवश्यक था, ताकि अनुरोध भेजते समय तुलना करने के लिए कुछ हो। मैं पूरी तरह से मंदबुद्धि नहीं हूं, लेकिन फिर भी यह मुझे मुश्किल लग रहा था। शायद यह एसएसएल के साथ काम करते समय आपको भविष्य में मदद करेगा। हम https के माध्यम से वांछित साइट पर जाते हैं, प्रमाण पत्र और निर्यात में प्रहार करते हैं। लेकिन उनमें से 3 हैं, जो एक की जरूरत है? “शेल्फ से एक पाई ले लो; उनमें से दो हैं, बीच में ले लो। ” यह पता चला है कि आपको प्रमाणन प्राधिकरण (रूट) और मध्यवर्ती (यैंडेक्स) का प्रमाण पत्र निर्यात करने की आवश्यकता है। अंतिम प्रमाणपत्र साल में एक बार बदलता है और अगर हम इसे एक श्रृंखला में दर्ज करते हैं और इसे खराब होने पर बदलना भूल जाते हैं, तो हमारे आवेदन में सब कुछ टूट जाएगा। इसलिए, हम केवल संकेतित 2 प्रमाणपत्रों को निर्यात करते हैं और उन्हें केवल एक पाठ फ़ाइल ( स्क्रीनशॉट ) में सहेजते हैं। मेरी लाइब्रेरी में, वह ym.crt के रूप में दिखाई देता है ।

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

एन्क्रिप्शन

एन्क्रिप्शन के साथ अभी भी छोटी कठिनाइयाँ थीं। सबसे पहले, उपयोगकर्ता टोकन को सहेजना / बहाल करना मानक मैक्रिप्ट पीएचपी लाइब्रेरी द्वारा कार्यान्वित किया गया था। लेकिन, जैसा कि यह निकला, उसके साथ समस्याएं हैं। उदाहरण के लिए, मैनुअल में लिए गए उदाहरणों से, केवल एक पदावनत समारोह ने तुरंत काम किया। अन्य कार्यों ने उन्हें काम करने की मेरी इच्छा पर थूक दिया, और केवल असफल मॉड्यूल आरंभीकरण के बारे में कुछ कहा। इसे समझना आवश्यक था। तब यह पता चला कि हॉस्टलर्स इस लाइब्रेरी के बहुत शौकीन नहीं हैं। मैंने अपने होस्टर्स के समर्थन से पूछा कि PHP 5.3 में साइट बनाते समय कोई मैक्रोक्रिप्ट मॉड्यूल क्यों नहीं है। उन्होंने मुझे जवाब दिया (शब्दशः): "वह 5.2 साल से बगिया में है - उन्होंने इसे 5.3 में एक मॉड्यूल के रूप में स्वचालित रूप से नहीं रखा, जिसे आप हर पांच साल में याद करते हैं, लेकिन इसके साथ समस्याएं थीं।" मुझे PHP में सममित एन्क्रिप्शन के कार्यान्वयन के साथ अन्य सुविधाजनक मानक पुस्तकालय नहीं मिले (एक ओपनएसएसएल पुस्तकालय है, लेकिन यह इसके लिए काफी नहीं है)। उसके बाद, मैंने एन्क्रिप्शन लाइब्रेरी को phpseclib में बदलने का फैसला किया, जो कि खुला है और लोकप्रिय एईएस एल्गोरिथ्म का समर्थन करता है। उसने तुरंत और बिना किसी समस्या के कमाई की।

कार्यक्षमता और उपयोग के उदाहरण

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

नतीजतन, निम्नलिखित Yandex.Money एपीआई कार्यों के लिए कॉल लागू किए गए थे: खाते की जानकारी, लेनदेन का इतिहास, संचालन की विस्तृत जानकारी, अन्य उपयोगकर्ताओं के लिए धन हस्तांतरण। पेशेवरों और सुविधाओं:

• OAuth उपयोगकर्ता प्राधिकरण;
• कार्य सुरक्षा (प्रमाण पत्र श्रृंखला सत्यापन समर्थित है);
• काम की सुविधा (सर्वर प्रतिक्रियाओं को वस्तुओं के रूप में दर्शाया गया है) और त्वरित शुरुआत;
• एन्क्रिप्शन का उपयोग कर और डेटाबेस का उपयोग किए बिना उपयोगकर्ता टोकन के भंडारण के लिए एक अपेक्षाकृत सुरक्षित और सरल समाधान। आप इस समाधान के कार्यान्वयन को अपनी रिपॉजिटरी में आसानी से लिख सकते हैं।

पुस्तकालय स्वयं एक ym.crt प्रमाणपत्र श्रृंखला फ़ाइल और एक ym.php फ़ाइल है जिसमें शामिल हैं:

• IYandexMoney सॉफ़्टवेयर इंटरफ़ेस;
• YandexMoney मुख्य वर्ग (इंटरफ़ेस कार्यान्वयन);
• अभिगम अधिकार (गुंजाइश) के साथ गणन वर्ग;
• सहायक कक्षाएं (एपीआई अनुरोधों के परिणामों की प्रतिक्रिया-वस्तुएं)।

लाइब्रेरी 2 फाइलें लेकर आती है जो एन्क्रिप्शन को लागू करती हैं: Rijndael.php और AES.php। ये फाइलें phpseclib लाइब्रेरी से ली गई हैं। यदि आप टोकन को बचाने और पुनर्स्थापित करने के तरीकों का उपयोग करते हैं, तो उनकी आवश्यकता होती है।
नोट: PHP संस्करण 5, साथ ही http अनुरोधों के लिए cUrl मानक पुस्तकालय का उपयोग करता है।

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

  YandexMoney :: प्राधिकृत (कॉन्स्टेंस :: CLIENT_ID, 'खाता-जानकारी संचालन-इतिहास', कॉन्स्टेंस :: REDIRECT_URL);

 // फिर रीडायरेक्ट पेज पर ऑब्जेक्ट के निर्माण और टोकन प्राप्त करने की पहल करता है
 $ ym = नया YandexMoney (consts :: CLIENT_ID, Consts :: CERTIFICATE_CHAIN_PATH);	
 $ टोकन = $ ym-> ReceOAuthToken ($ _ GET ['कोड'], Const :: REDIRECT_URL); 

ऑब्जेक्ट $ ym बनाते समय, सर्टिफिकेट चेन (फाइल ym.crt) के लिए सर्वर पर एप्लिकेशन आइडेंटिफायर और एब्सोल्यूट पाथ इसके पास जाता है। दोनों कि, और एक अन्य आमतौर पर किसी भी मॉड्यूल में स्थिरांक में पंजीकृत है (हमारे उदाहरणों में consts.php)।
खैर, आइए दिखाते हैं कि उपयोगकर्ता के खाते के बारे में जानकारी कैसे प्राप्त करें। उसी तरह, एक ऑब्जेक्ट बनाएं और फिर विधि को कॉल करें, इसे उपयोगकर्ता टोकन पास करते हुए:

  $ ym = नया YandexMoney (consts :: CLIENT_ID, Consts :: CERTIFICATE_CHAIN_PATH);
 $ खाताइन्फो रिप्रेंट = $ ym-> खाताइन्फो ($ टोकन);			

 गूंज 'खाता संख्या:'।  $ accountInfoResponse-> getAccount ()।  "\ _";
 इको 'बैलेंस:'।  $ accountInfoResponse-> getBalance ()।  "\ _";
 गूंज 'मुद्रा कोड:'।  $ accountInfoResponse-> getCurrency ()।  "\ _"; 

खाते की जानकारी प्राप्त की।

अन्य चुनौतियों के साथ भी स्थिति ऐसी ही है।

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