Quick Start API

คู่มือนี้จะพาคุณจากจุดเริ่มต้นสู่คำร้องที่สำเร็จครั้งแรก: สร้าง Personal Token, รู้จัก Base URL และเรียก REST Endpoint

ขั้นตอนที่ 1. สร้าง Personal Token

เปิดพื้นที่ส่วนตัว ไปที่ส่วน Personal Token แล้วสร้างโทเค็นใหม่ (PAT) คัดลอกค่าทันที — ค่านี้แสดง ครั้งเดียว และขึ้นต้นด้วย Prefix mbp_ เมื่อสร้างให้เลือก Scope ที่เพียงพอสำหรับงานของคุณ ดูรายละเอียดเพิ่มเติมใน คู่มือการยืนยันตัวตน

ขั้นตอนที่ 2. Base URL และรูปแบบ

REST Endpoint ทั้งหมดอยู่ภายใต้ Prefix /api ไม่มีการกำหนด Version ใน Path Body ของคำร้องและการตอบกลับเป็น JSON ส่ง Header Content-Type: application/json สำหรับคำร้องที่มี Body โทเค็นส่งผ่าน Header Authorization: Bearer mbp_…

ขั้นตอนที่ 3. คำร้องแรก — รายการบอท

ทดสอบโทเค็นด้วยการดึงรายการบอทของคุณ ต้องใช้ Scope bots:read (หรือ *):

curl -H "Authorization: Bearer mbp_YOUR_TOKEN" https://your-domain/api/bots

การตอบกลับจะเป็น JSON Array ของบอท หากโทเค็นไม่ถูกต้องหรือหมดอายุจะได้รับ 401 พร้อม Body {"error":"..."} (ดู ข้อผิดพลาด)

ขั้นตอนที่ 4. การเปลี่ยนแปลงครั้งแรก — สร้างรีแอคชัน

การสร้างรีแอคชันต้องใช้ Scope reactions:write แทน ID บอทจากขั้นตอนที่ 3:

curl -X POST -H "Authorization: Bearer mbp_YOUR_TOKEN" -H "Content-Type: application/json" -d '{"name":"Hello","trigger":{"type":"command","value":"/start"}}' https://your-domain/api/bots/BOT_ID/reactions

การตอบกลับที่สำเร็จจะส่งคืนรีแอคชันที่สร้างพร้อม id ดูฟิลด์ใน Body ที่แน่นอนได้ที่ เอกสารอ้างอิงแบบ Interactive — ซึ่งสร้างตัวอย่างสำเร็จรูปบน curl, JavaScript และ Python สำหรับแต่ละ Endpoint

ขั้นตอนที่ 5. ต่อไป — ตามเอกสารอ้างอิง

เมื่อโทเค็นทำงานได้แล้ว ส่วนที่เหลือสะดวกกว่าในการศึกษาจาก เอกสารอ้างอิงแบบ Interactive: ดูรายการ Endpoint ทั้งหมด, Scope ที่จำเป็น, Schema ของ Body และปุ่ม «Try it»

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