स्पैम से बचाने के लिए हम Yandex.Clean Web का उपयोग करते हैं

Yandex काफी समय से Yandex.Clean Web नामक संदेशों में स्पैम का पता लगाने के लिए एक मुफ्त सेवा प्रदान कर रहा है, लेकिन अभी तक यह अलोकप्रिय बना हुआ है।

इस पोस्ट में मैं एक साधारण PHP क्लास के उदाहरण का उपयोग करके Yandex.Clean Web API के साथ काम करने के बुनियादी तरीकों का प्रदर्शन करूँगा।

तो, सेवा चार तरीकों का समर्थन करती है - स्पैम का पता लगाना, कैप्चा प्राप्त करना, दर्ज कैप्चा की जाँच करना और स्पैम डिटेक्टर के निर्णय की अपील करना। हम पहले तीन तरीकों के साथ काम करने पर विचार करेंगे।

सुविधा के लिए, हम एक साधारण स्थिर वर्ग के रूप में यह सब व्यवस्था करेंगे।

class YandexCW { public static $api_key = '12345'; /* URL- */ const check_data_url = 'http://cleanweb-api.yandex.ru/1.0/check-spam'; const get_captcha_url = 'http://cleanweb-api.yandex.ru/1.0/get-captcha'; const check_captcha_url = 'http://cleanweb-api.yandex.ru/1.0/check-captcha'; } 

हम वर्ग विधियों को लागू करने के लिए आगे बढ़ते हैं। क्लीन वेब एपीआई आवश्यक विधि के आधार पर GET और POST अनुरोध स्वीकार करता है, और XML प्रारूप में परिणाम देता है। इसलिए, पहले, हम अपनी कक्षा में अनुरोध भेजने और प्रतिक्रियाएं पढ़ने के लिए एक सरल निजी विधि लिखेंगे। हम जवाब पढ़ने के लिए SimpleXML का उपयोग करेंगे, लेकिन हम CURL का उपयोग नहीं करेंगे - सौभाग्य से, मानक file_get_contents फ़ंक्शन आपको संदर्भों का उपयोग करके GET और POST दोनों अनुरोध करने की अनुमति देता है ।

 /*    */ private function xml_query($url, $parameters = array(), $post = false) { if (!isset($parameters['key'])) $parameters['key'] = self::$api_key; $parameters_query = http_build_query($parameters); if ($post) { $http_options = array( 'http' => array ( 'method' => 'POST', 'content' => $parameters_query ) ); $context = stream_context_create($http_options); $contents = file_get_contents($url, false, $context); } else $contents = file_get_contents($url.'?'.$parameters_query); if (!$contents) return false; $xml_data = new SimpleXMLElement($contents); return $xml_data; } 

यह विधि एपीआई के साथ हमारे काम को बहुत सरल कर देगी - यह स्वचालित रूप से कुंजी को प्रतिस्थापित करता है, फ़ाइल_get_contents के लिए संदर्भ बनाता है, अगर हमें एक POST अनुरोध करने की आवश्यकता होती है, और एक SimpleXML ऑब्जेक्ट के रूप में प्रतिक्रिया भी देता है। मुझे लगता है कि कोड को अधिक विस्तृत टिप्पणी की आवश्यकता नहीं है। तो चलिए एपीआई के साथ काम करने के तरीकों पर सीधे चलते हैं।

स्पैम के लिए संदेशों की जाँच करना

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

• आईपी - प्रेषक का आईपी पता।
• ईमेल - प्रेषक का ईमेल पता।
• नाम - संदेश हस्ताक्षरों में प्रदर्शित प्रेषक का नाम।
• लॉगिन - संसाधन पर उपयोगकर्ता खाते का नाम।
• realname - उपयोगकर्ता का नाम, उदाहरण के लिए, उसके पंजीकरण डेटा से।
• सब्जेक्ट-प्लेन - पोस्ट सब्जेक्ट इन टेक्स्ट / प्लेन फॉर्मेट।
• सब्जेक्ट-html - टेक्स्ट / html फॉर्मेट में पोस्ट सब्जेक्ट।
• विषय-बीबीसीकोड - बीबीसीोड प्रारूप में पोस्ट विषय।
• body-plain - पाठ / सादे प्रारूप में टिप्पणी या पोस्ट की सामग्री (शरीर)।
• body-html - पाठ / HTML प्रारूप में टिप्पणी या पोस्ट की सामग्री (शरीर)।
• body-bbcode - बीबीसीकोड प्रारूप में टिप्पणी या पोस्ट की सामग्री (शरीर)।

सत्यापन के लिए भेजे गए डेटा का सेट मनमाना हो सकता है, सिवाय इसके कि शरीर और विषय पैरामीटर परिवार से केवल एक ही प्रकार निर्दिष्ट किया जा सकता है - या तो सादे , या html , या bbcode । आवश्यक पैरामीटर भी नहीं हैं। इसलिए, हम यह सभी डेटा हमारी पद्धति में स्थानांतरित नहीं करेंगे, क्रमिक रूप से पैरामीटर नहीं, बल्कि एक मनमाना डेटा सेट के साथ एक सरणी के रूप में।

 /*    */ public function is_spam($message_data, $return_full_data = false) { if (!isset($message_data['ip'])) $ip = $_SERVER['REMOTE_ADDR']; $response = self::xml_query(self::check_data_url, $message_data, true); $spam_detected = (isset($response->text['spam-flag']) && $response->text['spam-flag'] == 'yes'); if (!$return_full_data) return $spam_detected; return array( 'detected' => $spam_detected, 'request_id' => (isset($response->id)) ? $response->id : null, 'spam_links' => (isset($response->links)) ? $response->links : array() ); } 

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

कैप्चा प्राप्त करना

यैंडेक्स हमें अपने स्वयं के "कैप्चा" का उपयोग करने की पेशकश करता है और मुझे कहना होगा कि इस समाधान के स्पष्ट लाभ हैं - सबसे पहले, हमारे सर्वर पर लोड कम हो जाता है, और दूसरी बात, कैप्चा के "दरार प्रतिरोध" के बारे में चिंता यैंडेक्स के कंधों पर पड़ती है। यह विधि अत्यंत सरल होगी:

  /*  CAPTCHA */ public function get_captcha($id = null) { $response = self::xml_query(self::get_captcha_url, array('id' => $id)); if (!$response || !isset($response->captcha)) return false; return array('captcha_id' => $response->captcha, 'captcha_url' => $response->url); } 

जैसा कि आप penultimate लाइन से देख सकते हैं, तरीका कैप्चा आईडी और इमेज का लिंक देता है।
लिंक, एक नियम के रूप में, निम्न रूप है:
u.captcha.yandex.net/image?key= कैप्चा आईडी

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

कैप्चा सत्यापन

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

  /*  CAPTCHA */ public function check_captcha($captcha_id, $captcha_value, $id = null) { $parameters = array( 'captcha' => $captcha_id, 'value' => $captcha_value, 'id' => $id ); $response = self::xml_query(self::check_captcha_url, $parameters); return isset($response->ok); } 

उपयोग के उदाहरण

क्लीन वेब सिस्टम की पूरी जांच के लिए, आप एक सरल डेमो स्क्रिप्ट डाउनलोड कर सकते हैं। जाँच करने से पहले, अपनी Clean Web API कुंजी प्राप्त करना न भूलें और इसे स्क्रिप्ट में निर्दिष्ट करें!
आप क्लास को अलग से भी डाउनलोड कर सकते हैं या ब्राउज़र में इसका पूरा कोड देख सकते हैं।

फार्म की सामग्री की जाँच:

 //       API require('YandexCW.class.php'); YandexCW::$api_key = '12345'; //      $allowed_keys = array('email', 'name', 'login', 'realname', 'subject-plain', 'body-plain'); $post_data = array_intersect_key($_POST, array_fill_keys($allowed_keys, null)); $is_spam = YandexCW::is_spam($post_data, true); //    var_dump($is_spam); 

विशेषताएं

एपीआई विधियों को कॉल करते समय अधिकांश पैरामीटर वैकल्पिक होते हैं।
उदाहरण के लिए, आप स्पैम चेकिंग का उपयोग नहीं कर सकते हैं, लेकिन बस यैंडेक्स कैप्चा को अपने आप से कनेक्ट करें, उसी तरह जैसे कि ReCAPTCHA जुड़ा हुआ है।
Api.yandex.ru पर और पढ़ें।