API
RibLink.ru सिस्टम के घटकों के साथ इंटरैक्शन के लिए एकीकृत प्रोग्रामिंग इंटरफ़ेस प्रदान करता है।
RibLink.ru के API पर भेजा गया अनुरोध POST या GET पैरामीटर, उस उपयोगकर्ता का ID (पैरामीटर user_id) जिसके नाम से अनुरोध किया जा रहा है, और एक कुंजी (पैरामीटर skey) को भेजकर किया जाता है। यह कुंजी, कुंजी के अनुसार क्रमबद्ध पैरामीटर (प्रतीक ":" के माध्यम से “जोड़े” गए) और उपयोगकर्ता की गुप्त कुंजी को sha256 विधि से एन्क्रिप्ट करके बनाई जाती है। PHP में API कुंजी बनाने का उदाहरण इस प्रकार है: hash_hmac('sha256', implode(':', $params), {Ваш API ключ из панели управления}, false)
आपकी API कुंजी: देखने के लिए सिस्टम में लॉगिन करें
आप किस भाषा (en, ru, de, fr, es, zh, hi) और किस प्रारूप (JSON या XML) में उत्तर प्राप्त करना चाहते हैं, इसके अनुसार अनुरोध लिंक का प्रारूप निर्धारित होता है।
उदाहरण: https://api.riblink.ruhi/request/json/campaigns/create
समान प्रकार के उत्तरों के सभी रूपों के लिए प्रविष्टियों की पुनरावृत्ति से बचने के लिए, यह मार्गदर्शिका API के साथ कार्य करने के विवरण पर केंद्रित होगी, जिसमें आपकी भाषा hi और डेटा के सबसे सरल वर्णन प्रारूप - JSON - का उपयोग किया जाएगा।
API से प्राप्त उत्तर दो प्रकार के हो सकते हैं:
1. ऑपरेशन सफल: {result: true, data: ... }
2. त्रुटि: {result: false, data: "त्रुटि का विवरण"}, या {result: false, data: {"param1" => "त्रुटि का विवरण", "param2" => "त्रुटि का विवरण2", ...}}
कृपया ध्यान दें कि API के माध्यम से प्राप्त सभी तारीखें और समय उस उपयोगकर्ता के समय क्षेत्र में दर्शाए जाते हैं, जिसके नाम से अनुरोध किया गया है। उपयोगकर्ता का समय क्षेत्र सेटिंग्स में बदला जा सकता है।
आप तैयार समाधान का उपयोग भी कर सकते हैं और उदाहरणों सहित PHP API क्लाइंट डाउनलोड कर सकते हैं।
ऑपरेशंस
नोट: अनिवार्य फ़ील्ड्स को नीले रंग से दिखाया गया है.
कैंपेन बनाना / कैंपेन डेटा अपडेट करना
https://api.riblink.ru/hi/request/json/campaigns/createपैरामीटर्स:
- title - कैंपेन का नाम
- campaign_id - यदि आप पहले से बनाए गए कैंपेन का डेटा अपडेट करना चाहते हैं, तो कैंपेन ID
- links_type - लिंक प्रकार: 0 - केवल key (डिफ़ॉल्ट), 1 - key और लिंक का भाग
- ads_type - विज्ञापन प्रकार: 0 - बंद, 1 - लोडिंग पेज (डिफ़ॉल्ट)
- ads_popunder - Popunder/Clickunder कनेक्ट करें (डिफ़ॉल्ट रूप से चालू)
- ads_adult - एडल्ट विज्ञापन (adult) की अनुमति दें (डिफ़ॉल्ट रूप से बंद)
- ads_interval - एक ही व्यक्ति को विज्ञापन दिखाने का अंतराल (सेकंड): 0 - बिना सीमा (डिफ़ॉल्ट), 3600 - प्रति घंटा एक बार, 86400 - प्रतिदिन एक बार
- show_dest_url - उपयोगकर्ता को अंतिम गंतव्य लिंक दिखाएं (डिफ़ॉल्ट रूप से बंद)
- links_title - सभी लिंक्स के लिए हेडर
- links_description - सभी लिंक के लिए विवरण
- links_button - जंप बटन का टेक्स्ट
- public_stat - लिंक पर सार्वजनिक सांख्यिकी
- password - लिंक का पासवर्ड
- password_confirm - पासवर्ड दोहराएं
- domain_id - उस डोमेन की ID जिसे आपने पहले कनेक्ट किया था। कैंपेन के सभी लिंक इसी डोमेन का उपयोग करेंगे
उत्तर का उदाहरण:
{
"result": true,
"data": {
"id": 521,
"title": "My new campaign",
"type": "manual",
"status": "active",
"ads_type": 0,
"ads_popunder": 1,
"ads_adult": 0,
"ads_interval": 0,
"links_type": 0,
"show_dest_url": 0,
"links_title": "",
"links_description": "",
"links_button": "",
"has_links_password": true,
"domain": "https://rib1.ru",
"public_stat": 0,
"urls_amount": 0,
"created": "2017-09-15 20:38:54"
}
}
कैंपेन डेटा प्राप्त करना
https://api.riblink.ru/hi/request/json/campaigns/getपैरामीटर्स:
- campaign_id - कैंपेन ID
उत्तर का उदाहरण:
{
"result": true,
"data": {
"id": 521,
"title": "My new campaign",
"type": "manual",
"status": "active",
"ads_type": 0,
"ads_popunder": 1,
"ads_adult": 0,
"ads_interval": 0,
"links_type": 0,
"show_dest_url": 0,
"links_title": "",
"links_description": "",
"links_button": "",
"has_links_password": true,
"domain": "https://rib1.ru",
"public_stat": 0,
"urls_amount": 0,
"created": "2017-09-15 20:38:54"
}
}
लिंक बनाना / लिंक डेटा अपडेट करना
https://api.riblink.ru/hi/request/json/campaigns/links/createपैरामीटर्स:
- url - वह लिंक जिसे छोटा/परिवर्तित करना है
- link_id - यदि आप मौजूदा लिंक का डेटा अपडेट करना चाहते हैं तो लिंक ID
- campaign_id - उस कैंपेन की ID जिसमें लिंक जोड़ा जाएगा (केवल नया बनाते समय)। यदि नहीं दिया गया तो लिंक डिफ़ॉल्ट कैंपेन में जोड़ा जाएगा
- url_key - लिंक key (शॉर्ट लिंक किससे समाप्त होगा)। यदि नहीं दी गई है, तो रैंडम बनाई जाएगी
- title - लिंक का नाम
- description - लिंक का विवरण
- button - जंप बटन का टेक्स्ट
- comment - लिंक पर टिप्पणी (केवल आप देख सकते हैं)
उत्तर का उदाहरण:
{
"result": true
}
लिंक डेटा प्राप्त करना
https://api.riblink.ru/hi/request/json/campaigns/links/getपैरामीटर्स:
- link_id - लिंक ID
- url_key - लिंक key (शॉर्ट लिंक का अंत भाग)
उत्तर का उदाहरण:
{
"result": true,
"data": {
"id": 36523,
"campaign_id": 521,
"campaign_title": "My new campaign",
"url_key": "bx5i",
"url": "https://riblink.ru/index/rules",
"title": "",
"description": "",
"button": "",
"comment": "",
"created": "2017-09-16 13:23:24"
}
}