Xác thực
Xác thực các yêu cầu BoxHero API bằng Bearer token và gửi chúng đến URL cơ sở có phiên bản.
API token
Phần tiêu đề “API token”Mọi yêu cầu phải mang theo API token dưới dạng Bearer token trong header Authorization:
Authorization: Bearer <api-token>Cấp token trong ứng dụng BoxHero tại Cài đặt > Tích hợp. Mỗi token gắn với một nhóm duy nhất: mọi yêu cầu chỉ đọc và ghi dữ liệu của nhóm đó. Để làm việc với nhiều nhóm, hãy cấp token trong từng nhóm.
Không hỗ trợ truy cập ẩn danh. Khi token bị thiếu hoặc không hợp lệ, mọi endpoint đều trả về 401 kèm cấu trúc phản hồi lỗi.
URL cơ sở và phiên bản
Phần tiêu đề “URL cơ sở và phiên bản”Mọi yêu cầu đều gửi đến:
https://rest.boxhero-app.comMọi endpoint đều nằm dưới tiền tố /v1 — ví dụ: GET /v1/items.