Bắt đầu nhanh API

Hướng dẫn này sẽ dẫn bạn từ đầu đến yêu cầu thành công đầu tiên: tạo token cá nhân, tìm địa chỉ cơ sở và gọi REST endpoint.

Bước 1. Tạo token cá nhân

Mở trang cá nhân, mục token cá nhân, và tạo token mới (PAT). Sao chép giá trị ngay lập tức — nó chỉ hiển thị một lần và bắt đầu bằng tiền tố mbp_. Khi tạo, hãy chọn các phạm vi truy cập (scopes) đủ cho nhiệm vụ của bạn; xem chi tiết trong hướng dẫn xác thực.

Bước 2. Địa chỉ cơ sở và định dạng

Tất cả REST endpoint đều nằm dưới tiền tố /api. Không có versioning trong đường dẫn. Nội dung yêu cầu và phản hồi là JSON; hãy truyền header Content-Type: application/json cho các yêu cầu có nội dung. Token được truyền qua header Authorization: Bearer mbp_….

Bước 3. Yêu cầu đầu tiên — danh sách bot

Kiểm tra token bằng yêu cầu danh sách bot của bạn. Cần scope bots:read (hoặc *):

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

Phản hồi sẽ là mảng JSON các bot. Nếu token sai hoặc hết hạn — sẽ trả về 401 với nội dung {"error":"..."} (xem lỗi).

Bước 4. Mutation đầu tiên — tạo phản ứng

Tạo phản ứng yêu cầu scope reactions:write. Thay thế định danh bot từ bước 3:

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

Phản hồi thành công sẽ trả về phản ứng đã tạo với id của nó. Xem các trường nội dung chính xác trong tài liệu tham khảo tương tác — nó tạo sẵn ví dụ trên curl, JavaScript và Python cho từng endpoint.

Bước 5. Tiếp tục — theo tài liệu tham khảo

Khi token hoạt động, phần còn lại thuận tiện hơn để khám phá trong tài liệu tham khảo tương tác: ở đó có danh sách đầy đủ endpoint, scopes cần thiết, schema nội dung và nút "Try it".

Tiếp theo