المصادر والمفاتيح

بالإضافة إلى التكاملات الجاهزة، يستطيع GetMyBot العمل مع HTTP APIs اعتباطية عبر الموصّلات (قسم المصادر) وبيانات الاعتماد (قسم المفاتيح). يصف الموصّل إلى أين نذهب، والمفتاح — كيف نتفوّض. تستخدمها إجراءات الاستعلام من المصدر والكتابة في المصدر.

الموصّلات (المصادر)

قسم المصادر → الموصّلات. لكل موصّل اسم ونوع وURL أساسي وبيانات اعتماد مرتبطة وترويسات:

  • REST — أي HTTP/JSON API.
  • OzmaDB — نسخة OzmaDB/FunDB؛ يُحدَّد جذر REST API للنسخة في URL الأساسي، وطلبات العروض المجهولة مبسّطة.
  • IMAP — مُعلَّم كـ «قريباً».

زر التحقق ينفّذ طلباً تجريبياً ويعرض الحالة والتأخير (أو الخطأ) — مناسب للتأكد من صحة URL والمفتاح.

بيانات الاعتماد (المفاتيح)

قسم المفاتيح → بيانات الاعتماد. تُخزَّن الأسرار بشكل مشفر. الأنواع:

  • مفتاح API — المفتاح واسم الترويسة (افتراضياً Authorization).
  • Bearer token — رمز في ترويسة Authorization: Bearer.
  • OAuth2 (password) — Token URL وClient ID/Secret وتسجيل الدخول وكلمة المرور والـ scope.
  • OAuth2 (refresh) — Token URL وClient ID/Secret وreset token والـ scope.

بالنسبة لـ OAuth2 تحصل المنصة على الرموز وتضعها في ذاكرة مؤقتة تلقائياً، وتجدّدها عند انتهاء الصلاحية وعند استجابة 401؛ يُحفظ تدوير الـ refresh token. عند التعديل، الحقل الفارغ للسر يعني «لا تغيير».

القراءة والكتابة من التفاعلات

  • الاستعلام من المصدر (ds_query) — يقرأ البيانات عبر الموصّل في ctx: يُحدَّد المسار وJSONPath إلى المصفوفة ومفتاح ctx للنتيجة. بعدها تُكرَّر المصفوفة في حلقة على القائمة.
  • الكتابة في المصدر (ds_write) — يرسل البيانات (POST/PUT/DELETE) بجسم بصيغة JSON.

للطلبات الفردية بدون موصّل محفوظ، توجد إجراءات طلب الويب لتنزيل نص صفحة — تحميل URL (راجع الإجراءات).

الخطوات التالية