> 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/id/developers/api/quickstart.md).

# Mulai Cepat

> Terbitkan token API dan kirim permintaan pertama Anda ke BoxHero API.

Panduan ini memandu Anda dari belum memiliki token hingga panggilan API pertama yang berhasil.

## 1. Terbitkan token API

Di aplikasi web desktop, buka tim yang ingin Anda hubungkan, lalu buka `Pengaturan` > `Integrasi`. Buat token API baru lalu salin.

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

> **Caution**
>
> **Catatan**: Token terikat ke tim tempat token tersebut diterbitkan dan memberikan akses penuh ke data tim tersebut melalui API. Simpan di server Anda — jangan pernah menaruhnya di aplikasi seluler, kode browser, atau repositori publik.

## 2. Kirim permintaan pertama Anda

Panggil [Ambil tim yang terhubung](https://www.boxhero.io/docs/id/developers/api/reference/teams/get-linked-team) untuk memastikan token berfungsi. Kirim token di header `Authorization`:

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

Respons menjelaskan tim pemilik token tersebut:

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

Jika Anda malah mendapatkan `401`, token tidak ada atau tidak tersalin dengan lengkap. Lihat [Error](https://www.boxhero.io/docs/id/developers/api/errors) untuk format error.

> **Note**
>
> Sebagian besar endpoint hanya berfungsi untuk tim yang mengelola stok berdasarkan [lokasi](https://www.boxhero.io/docs/id/concepts/locations). Untuk tim lain, endpoint tersebut mengembalikan error bertipe `/errors/invalid-team-mode`. Tim berbasis lokasi memiliki `mode` bernilai `2` pada respons di atas.

## 3. Langkah selanjutnya

- Tampilkan daftar stok Anda dengan [Daftar barang](https://www.boxhero.io/docs/id/developers/api/reference/items/list-items), dan pelajari cara mengambil semua halaman di [Paginasi](https://www.boxhero.io/docs/id/developers/api/pagination).
- Catat perubahan stok dengan [Buat transaksi](https://www.boxhero.io/docs/id/developers/api/reference/transactions/create-transaction) — lihat [Transaksi](https://www.boxhero.io/docs/id/developers/api/reference/transactions) untuk aturannya.
- Dapatkan notifikasi perubahan tanpa perlu polling dengan [Webhook](https://www.boxhero.io/docs/id/developers/webhooks/overview).
- Jelajahi semua endpoint di [Referensi API](https://www.boxhero.io/docs/id/developers/api/reference).