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

# 빠른 시작

> API 토큰을 발급하고 박스히어로 API에 첫 요청을 보냅니다.

API 토큰 발급부터 첫 API 호출 성공까지의 과정을 안내합니다.

## 1. API 토큰 발급

PC 웹 버전에서 연동할 팀에 접속한 후, `설정` > `연동 설정` 메뉴에서 새 API 토큰을 생성하고 복사해 주세요.

![API 토큰 생성 화면](https://assets.boxhero.io/docs/images/782a50fee397fb35fd9253ed7c73b85968331e201be7267a0e8e5d29ba16d681-1200x683.png)

> **Caution**
>
> API 토큰은 발급한 팀에 연결되며, 그 팀의 데이터에 API로 접근할 수 있는 모든 권한을 가집니다. 토큰은 서버에만 보관하고, 모바일 앱이나 브라우저 코드, 공개 저장소에는 절대 넣지 마세요.

## 2. 첫 요청 보내기

[Get the linked team](https://www.boxhero.io/docs/ko/developers/api/reference/teams/get-linked-team)을 호출해 토큰이 정상적으로 동작하는지 확인합니다. 토큰은 `Authorization` 헤더에 담아 보냅니다.

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

응답으로 토큰이 연결된 팀의 정보가 반환됩니다.

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

`401`이 반환된다면 토큰이 없거나 일부만 복사된 경우입니다. 오류 형식은 [오류](https://www.boxhero.io/docs/ko/developers/api/errors)를 참고해 주세요.

> **Note**
>
> 대부분의 엔드포인트는 [위치](https://www.boxhero.io/docs/ko/concepts/locations)별로 재고를 관리하는 팀에서만 사용할 수 있습니다. 그 외의 팀에서는 `/errors/invalid-team-mode` 유형의 오류가 반환됩니다. 위치를 사용하는 팀은 위 응답의 `mode` 값이 `2`입니다.

## 3. 다음 단계

- [List items](https://www.boxhero.io/docs/ko/developers/api/reference/items/list-items)로 제품 목록을 조회하고, 모든 페이지를 가져오는 방법은 [페이지네이션](https://www.boxhero.io/docs/ko/developers/api/pagination)에서 확인해 보세요.
- [Create a transaction](https://www.boxhero.io/docs/ko/developers/api/reference/transactions/create-transaction)으로 입출고를 기록할 수 있습니다. 규칙은 [입출고](https://www.boxhero.io/docs/ko/developers/api/reference/transactions)를 참고해 주세요.
- 주기적으로 조회하는 대신 [웹훅](https://www.boxhero.io/docs/ko/developers/webhooks/overview)으로 변경 사항을 받아 보세요.
- 전체 엔드포인트는 [API 레퍼런스](https://www.boxhero.io/docs/ko/developers/api/reference)에서 확인할 수 있습니다.