Nguồn và khóa

Ngoài các tích hợp sẵn có, GetMyBot có thể làm việc với bất kỳ HTTP API nào thông qua connector (mục Nguồn) và thông tin xác thực (mục Khóa). Connector mô tả nơi đến, khóa — cách xác thực. Chúng được sử dụng bởi các hành động Yêu cầu đến nguồn và Ghi vào nguồn.

Connector (Nguồn)

Mục Nguồn → Connector. Connector có Tên, Loại, URL cơ sở, thông tin xác thực được liên kết và header:

  • REST — bất kỳ HTTP/JSON API nào.
  • OzmaDB — instance OzmaDB/FunDB; URL cơ sở chỉ định gốc REST API của instance, còn các yêu cầu đến anonymous view được đơn giản hóa.
  • IMAP — được đánh dấu là "sắp có".

Nút Kiểm tra thực hiện yêu cầu thử nghiệm và hiển thị trạng thái và độ trễ (hoặc lỗi) — tiện để xác nhận URL và khóa đúng.

Thông tin xác thực (Khóa)

Mục Khóa → Thông tin xác thực. Bí mật được lưu ở dạng mã hóa. Các loại:

  • API key — khóa + tên header (mặc định Authorization).
  • Bearer token — token trong header Authorization: Bearer.
  • OAuth2 (password) — Token URL, Client ID/Secret, đăng nhập, mật khẩu, scope.
  • OAuth2 (refresh) — Token URL, Client ID/Secret, refresh token, scope.

Đối với OAuth2, nền tảng tự động lấy và cache token, cập nhật khi hết hạn và khi nhận phản hồi 401; rotation của refresh token được lưu lại. Khi chỉnh sửa, trường bí mật trống có nghĩa là "không thay đổi".

Đọc và ghi từ phản ứng

  • Yêu cầu đến nguồn (ds_query) — đọc dữ liệu qua connector vào ctx: chỉ định đường dẫn, JSONPath đến mảng và khóa ctx cho kết quả. Tiếp theo mảng được duyệt qua vòng lặp theo danh sách.
  • Ghi vào nguồn (ds_write) — gửi dữ liệu (POST/PUT/DELETE) với nội dung định dạng JSON.

Để yêu cầu một lần không cần connector đã lưu, có hành động Yêu cầu web, và để tải văn bản trang — Tải URL (xem Hành động).

Tiếp theo