แหล่งข้อมูลและคีย์

นอกจาก การเชื่อมต่อ สำเร็จรูปแล้ว GetMyBot ยังสามารถทำงานกับ HTTP API ที่กำหนดเองผ่าน Connector (ส่วน แหล่งข้อมูล) และ ข้อมูลรับรอง (ส่วน คีย์) Connector อธิบาย ที่ใด ที่จะเชื่อมต่อ ส่วนคีย์อธิบาย วิธี การยืนยันตัวตน ใช้กับแอคชัน คำร้องไปยังแหล่งข้อมูล และ เขียนไปยังแหล่งข้อมูล

Connector (แหล่งข้อมูล)

ส่วน แหล่งข้อมูล → Connector แต่ละ Connector มี ชื่อ, ประเภท, Base URL, ข้อมูลรับรอง ที่ผูกไว้ และ Header:

  • REST — HTTP/JSON API ใดก็ได้
  • OzmaDB — Instance ของ OzmaDB/FunDB โดย Base URL ระบุ Root ของ REST API ของ Instance และคำร้องต่อ Anonymous View ถูกทำให้ง่ายขึ้น
  • IMAP — ระบุว่า «เร็วๆ นี้»

ปุ่ม ตรวจสอบ ส่งคำร้องทดสอบและแสดงสถานะและเวลาตอบสนอง (หรือข้อผิดพลาด) — สะดวกในการตรวจสอบว่า URL และคีย์ถูกต้อง

ข้อมูลรับรอง (คีย์)

ส่วน คีย์ → ข้อมูลรับรอง ความลับถูกเก็บในรูปแบบเข้ารหัส ประเภท:

  • API Key — คีย์ + ชื่อ Header (ค่าเริ่มต้นคือ Authorization)
  • Bearer Token — โทเค็นใน Header Authorization: Bearer
  • OAuth2 (password) — Token URL, Client ID/Secret, ชื่อผู้ใช้, รหัสผ่าน, Scope
  • OAuth2 (refresh) — Token URL, Client ID/Secret, Refresh Token, Scope

สำหรับ OAuth2 แพลตฟอร์มจะรับและ Cache Token เอง โดยต่ออายุเมื่อหมดอายุและเมื่อได้รับ 401 รวมถึงบันทึก Refresh Token ที่หมุนเวียน เมื่อแก้ไข ฟิลด์ความลับที่ว่างเปล่าหมายถึง «ไม่เปลี่ยน»

การอ่านและเขียนจากรีแอคชัน

  • คำร้องไปยังแหล่งข้อมูล (ds_query) — อ่านข้อมูลผ่าน Connector ไปยัง ctx: ระบุ Path, JSONPath ไปยัง Array และคีย์ ctx สำหรับผลลัพธ์ จากนั้น Array จะถูกวนซ้ำด้วย ลูปรายการ
  • เขียนไปยังแหล่งข้อมูล (ds_write) — ส่งข้อมูล (POST/PUT/DELETE) พร้อม Body ในรูปแบบ JSON

สำหรับคำร้องครั้งเดียวที่ไม่มี Connector ที่บันทึกไว้ มีแอคชัน Web Request และสำหรับการดาวน์โหลดข้อความของหน้า — โหลด URL (ดู แอคชัน)

ขั้นตอนถัดไป