منابع و کلیدها

علاوه بر یکپارچه‌سازی‌های آماده، GetMyBot می‌تواند با هر HTTP API دلخواهی از طریق کانکتورها (بخش منابع) و اطلاعات اعتباری (بخش کلیدها) کار کند. کانکتور توضیح می‌دهد کجا بروید، کلید — چگونه احراز هویت شود. از آن‌ها اقدامات درخواست به منبع و نوشتن در منبع استفاده می‌کنند.

کانکتورها (منابع)

بخش منابع → کانکتورها. یک کانکتور دارای نام، نوع، URL پایه، اطلاعات اعتباری متصل و هدرها است:

  • REST — هر HTTP/JSON API.
  • OzmaDB — نمونه OzmaDB/FunDB؛ در URL پایه ریشه REST API نمونه وارد می‌شود و درخواست‌های به view‌های ناشناس ساده‌تر هستند.
  • IMAP — به‌زودی علامت‌گذاری شده.

دکمه آزمایش یک درخواست آزمایشی می‌فرستد و وضعیت و تأخیر (یا خطا) را نشان می‌دهد — مناسب برای اطمینان از درستی URL و کلید.

اطلاعات اعتباری (کلیدها)

بخش کلیدها → اطلاعات اعتباری. اسرار به‌صورت رمزگذاری‌شده ذخیره می‌شوند. انواع:

  • کلید API — کلید + نام هدر (پیش‌فرض Authorization).
  • توکن Bearer — توکن در هدر Authorization: Bearer.
  • OAuth2 (password) — Token URL، Client ID/Secret، نام کاربری، رمز عبور، scope.
  • OAuth2 (refresh) — Token URL، Client ID/Secret، refresh-token، scope.

برای OAuth2 پلتفرم خودش توکن‌ها را دریافت و کش می‌کند، آن‌ها را هنگام انقضا و با پاسخ 401 به‌روز می‌کند؛ چرخش refresh-token ذخیره می‌شود. هنگام ویرایش، فیلد خالی راز به معنای «تغییر نده» است.

خواندن و نوشتن از واکنش‌ها

  • درخواست به منبع (ds_query) — داده را از طریق کانکتور در ctx می‌خواند: مسیر، JSONPath به آرایه و کلید ctx برای نتیجه مشخص می‌شود. سپس آرایه با حلقه روی فهرست پیمایش می‌شود.
  • نوشتن در منبع (ds_write) — داده (POST/PUT/DELETE) را با بدنه JSON ارسال می‌کند.

برای درخواست‌های تکی بدون کانکتور ذخیره‌شده، اقدام درخواست وب وجود دارد و برای دانلود متن صفحه — بارگذاری URL (ببینید اقدامات).

بیشتر بخوانید