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

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

Mọi yêu cầu đều gửi đến:

https://rest.boxhero-app.com

Mọi endpoint đều nằm dưới tiền tố /v1 — ví dụ: GET /v1/items.

Chế độ nhóm

Hầu hết endpoint chỉ dùng được cho các nhóm quản lý tồn kho theo vị trí. Với các nhóm khác, chúng trả về 400 với loại lỗi /errors/invalid-team-mode. Các endpoint về nhóm, thành viên, đối tác và thuộc tính hoạt động với mọi nhóm — hãy gọi Lấy nhóm được liên kết để xem nhóm của bạn đang dùng chế độ nào.