> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/vi/developers/api/quickstart.md).

# Bắt đầu nhanh

> Cấp API token và gửi yêu cầu đầu tiên đến BoxHero API.

Hướng dẫn này đưa bạn từ lúc chưa có token đến lệnh gọi API thành công đầu tiên.

## 1. Cấp API token

Trên ứng dụng web cho máy tính, mở nhóm bạn muốn kết nối và vào `Cài đặt` > `Tích hợp`. Tạo API token mới và sao chép nó.

![](https://assets.boxhero.io/docs/images/e6bbc8fa4eab21ec0f9ebe74893cd3a6e0c6a5d4d178ae02478ef99adbe4c4cd-2214x1431.jpg)

> **Caution**
>
> **Lưu ý**: Token gắn với nhóm đã cấp nó và cho phép toàn quyền truy cập dữ liệu của nhóm đó qua API. Chỉ lưu token trên máy chủ của bạn — tuyệt đối không đặt nó trong ứng dụng di động, mã chạy trên trình duyệt hay kho mã công khai.

## 2. Gửi yêu cầu đầu tiên

Gọi [Lấy nhóm được liên kết](https://www.boxhero.io/docs/vi/developers/api/reference/teams/get-linked-team) để kiểm tra token có hoạt động không. Gửi token trong header `Authorization`:

```bash
curl https://rest.boxhero-app.com/v1/teams/linked \
  -H "Authorization: Bearer $BOXHERO_API_TOKEN"
```

Phản hồi mô tả nhóm sở hữu token:

```json
{
  "id": 149058,
  "name": "Acme Retail",
  "mode": 2,
  "currency_symbol": "$",
  "currency_code": "USD",
  "price_decimal_places": 2,
  "memo": null
}
```

Nếu bạn nhận được `401`, token bị thiếu hoặc được sao chép chưa đầy đủ. Xem [Lỗi](https://www.boxhero.io/docs/vi/developers/api/errors) để biết định dạng lỗi.

> **Note**
>
> Hầu hết endpoint chỉ hoạt động với các nhóm quản lý tồn kho theo [vị trí](https://www.boxhero.io/docs/vi/concepts/locations). Với các nhóm khác, chúng trả về lỗi loại `/errors/invalid-team-mode`. Nhóm theo vị trí có `mode` là `2` trong phản hồi ở trên.

## 3. Bước tiếp theo

- Liệt kê tồn kho bằng [Liệt kê mặt hàng](https://www.boxhero.io/docs/vi/developers/api/reference/items/list-items), và tìm hiểu cách lấy mọi trang trong [Phân trang](https://www.boxhero.io/docs/vi/developers/api/pagination).
- Ghi nhận thay đổi tồn kho bằng [Tạo giao dịch](https://www.boxhero.io/docs/vi/developers/api/reference/transactions/create-transaction) — xem [Giao dịch](https://www.boxhero.io/docs/vi/developers/api/reference/transactions) để biết các quy tắc.
- Nhận thông báo khi có thay đổi thay vì phải truy vấn định kỳ bằng [Webhook](https://www.boxhero.io/docs/vi/developers/webhooks/overview).
- Xem mọi endpoint trong [Tài liệu tham khảo API](https://www.boxhero.io/docs/vi/developers/api/reference).