स्रोत और keys

तैयार इंटीग्रेशन के अलावा, GetMyBot कनेक्टर (सेक्शन स्रोत) और credentials (सेक्शन Keys) के ज़रिए मनमाने HTTP-API के साथ काम कर सकता है। कनेक्टर बताता है कहाँ जाना है, key — कैसे प्राधिकृत होना है। इन्हें स्रोत से अनुरोध और स्रोत में लिखना एक्शन उपयोग करते हैं।

कनेक्टर (स्रोत)

सेक्शन स्रोत → कनेक्टर। कनेक्टर में नाम, प्रकार, बेस URL, जुड़े credentials और हेडर होते हैं:

  • REST — कोई भी HTTP/JSON-API।
  • OzmaDB — OzmaDB/FunDB इंस्टेंस; बेस URL में REST API इंस्टेंस का रूट दर्शाया जाता है, और anonymous view के अनुरोध सरल हैं।
  • IMAP — «जल्द» के रूप में चिह्नित।

जाँचें बटन एक परीक्षण अनुरोध करता है और स्थिति और विलंब (या एरर) दिखाता है — यह सुनिश्चित करने के लिए उपयोगी है कि URL और key सही हैं।

Credentials (Keys)

सेक्शन Keys → Credentials। Secrets एन्क्रिप्टेड रूप में स्टोर होते हैं। प्रकार:

  • API-key — key + हेडर का नाम (डिफ़ॉल्ट Authorization)।
  • Bearer-टोकन — Authorization: Bearer हेडर में टोकन।
  • OAuth2 (password) — Token URL, Client ID/Secret, लॉगिन, पासवर्ड, scope।
  • OAuth2 (refresh) — Token URL, Client ID/Secret, refresh-टोकन, scope।

OAuth2 के लिए प्लेटफ़ॉर्म खुद टोकन प्राप्त करता और cache करता है, समाप्ति और 401 रिस्पॉन्स पर उन्हें अपडेट करता है; refresh-टोकन rotation सहेजी जाती है। संपादन करते समय खाली secret फ़ील्ड का मतलब «न बदलें»।

रिएक्शन से पढ़ना और लिखना

  • स्रोत से अनुरोध (ds_query) — कनेक्टर के ज़रिए ctx में डेटा पढ़ता है: path, array के लिए JSONPath और परिणाम के लिए ctx key दर्शाए जाते हैं। फिर array को सूची पर लूप से iterate किया जाता है।
  • स्रोत में लिखना (ds_write) — JSON फ़ॉर्मेट की बॉडी के साथ डेटा भेजता है (POST/PUT/DELETE)।

सहेजे गए कनेक्टर के बिना एकल अनुरोधों के लिए वेब-अनुरोध एक्शन है, और पेज का टेक्स्ट डाउनलोड करने के लिए — URL लोड करें (देखें एक्शन)।

आगे क्या