REST API और टोकन

विज़ुअल निर्माता के अलावा, GetMyBot प्रोग्रामेटिक रूप से भी खुला है: REST API के ज़रिए बॉट के डेटा को प्रबंधित किया जा सकता है। दो प्रकार के टोकन हैं — किसी विशिष्ट बॉट तक पहुँच के लिए और पर्सनल (अकाउंट-स्तरीय ऑटोमेशन और इंटीग्रेशन के लिए)।

बॉट के API-टोकन

सेटिंग्स → API-टोकन में बनाए जाते हैं। प्रत्येक टोकन बॉट से जुड़ा है और उसके REST एंडपॉइंट (रिएक्शन, उपयोगकर्ता, संग्रह, आँकड़े आदि) तक पहुँच देता है। टोकन बनाते समय केवल एक बार दिखाया जाता है — इसे सुरक्षित जगह सहेजें; सूची में नाम, मास्क और निर्माण तिथि दिखती है। अनावश्यक टोकन हटाएँ।

पर्सनल एक्सेस टोकन (PAT)

पर्सनल एक्सेस टोकन (PAT, mbp_ से शुरू होते हैं) अकाउंट स्तर पर काम करते हैं और ऑटोमेशन व इंटीग्रेशन के लिए उपयोग होते हैं। पर्सनल कैबिनेट में बनाए जाते हैं; Authorization: Bearer mbp_… हेडर में पास किए जाते हैं। टोकन के पास एक्सेस स्कोप होते हैं — resource:action फ़ॉर्मेट में अनुमतियों का सेट (जैसे reactions:read, bots:write), और * का मतलब पूर्ण एक्सेस है। वैधता अवधि सीमित होती है, और टोकन हैश किए गए रूप में स्टोर होते हैं। यह पासवर्ड दिए बिना स्क्रिप्ट को सीमित एक्सेस देने का सुविधाजनक तरीका है।

API के ज़रिए क्या उपलब्ध है

API के ज़रिए वही entities उपलब्ध हैं जो इंटरफ़ेस में हैं: बॉट और उनकी सेटिंग्स, रिएक्शन (इम्पोर्ट/एक्सपोर्ट सहित), सब्सक्राइबर और लेबल, संग्रह और रिकॉर्ड, आँकड़े और अनुरोध जर्नल, ब्रॉडकास्ट। इससे GetMyBot के ऊपर अपने डैशबोर्ड, सिंक्रोनाइज़ेशन और ऑटोमेशन बनाए जा सकते हैं।

चैनल और WhatsApp

GetMyBot मल्टीचैनल है (Telegram + WhatsApp + VK), और बॉट के चैनल REST के ज़रिए भी प्रबंधित होते हैं। चैनल और WhatsApp टेम्पलेट साझा scopes bots:read / bots:write द्वारा नियंत्रित होते हैं — चैनल के लिए अलग scope नहीं है।

  • GET /api/channels/capabilities — चैनलों की क्षमता-मैट्रिक्स (सेशन एंडपॉइंट, PAT scope की आवश्यकता नहीं)।
  • GET /api/bots/{botID}/channels (bots:read) — बॉट के चैनलों की सूची।
  • POST /api/bots/{botID}/channels (bots:write) — WhatsApp या VK चैनल जोड़ना।
  • DELETE /api/bots/{botID}/channels/{channelID} (bots:write) — चैनल हटाना।
  • GET /api/bots/{botID}/channels/{channelID}/templates (bots:read) — चैनल का WhatsApp टेम्पलेट कैटलॉग।
  • POST /api/bots/{botID}/channels/{channelID}/templates (bots:write) — टेम्पलेट बनाना और उसे Meta को जाँच के लिए भेजना।
  • POST /api/bots/{botID}/channels/{channelID}/templates/sync (bots:write) — Meta से कैटलॉग फिर से सिंक करना।
  • PUT /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — टेम्पलेट संपादित करना।
  • DELETE /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — टेम्पलेट हटाना।
  • POST /api/bots/{botID}/channels/{channelID}/templates/media (bots:write) — हेडर मीडिया उदाहरण अपलोड करना (छवि/वीडियो/दस्तावेज़)।

अनुरोध/प्रतिक्रिया स्कीमा, पैरामीटर और उदाहरण API संदर्भ में हैं।

मोबाइल एक्सेस

प्लेटफ़ॉर्म का अपना मोबाइल ऐप्लिकेशन है जिसमें अपनी ऑथेंटिकेशन (access- और refresh-टोकन) और बॉट का समेकित डैशबोर्ड है — यह वही बैकएंड उपयोग करता है।

API संदर्भ

पब्लिक API का पूर्ण इंटरेक्टिव संदर्भ API संदर्भ पृष्ठ पर उपलब्ध है: वहाँ PAT से उपलब्ध सभी एंडपॉइंट, पैरामीटर, अनुरोध और उत्तर की स्कीमा, आवश्यक scopes और तैयार उदाहरण (curl, JavaScript, Python) सूचीबद्ध हैं। पृष्ठ से सीधे अपने टोकन के साथ परीक्षण अनुरोध किया जा सकता है।

सुरक्षा

  • टोकन एक बार दिखाए जाते हैं; उन्हें secret की तरह सुरक्षित रखें।
  • बॉट और credentials के secret एन्क्रिप्टेड रूप में स्टोर होते हैं।
  • परिवर्तन ऑडिट जर्नल में दर्ज होते हैं।

आगे क्या