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

# Быстрый старт

> Выпустите API-токен и отправьте первый запрос к BoxHero API.

Это руководство проведёт вас от получения токена до первого успешного вызова API.

## 1. Выпустите API-токен

В веб-приложении для компьютера откройте команду, которую хотите подключить, и перейдите в `Настройки` > `Интеграции`. Создайте новый API-токен и скопируйте его.

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

> **Caution**
>
> **Примечание**: токен привязан к команде, в которой он выпущен, и даёт через API полный доступ к данным этой команды. Храните его на своём сервере — никогда не размещайте его в мобильном приложении, в коде для браузера или в публичном репозитории.

## 2. Отправьте первый запрос

Вызовите [Получение связанной команды](https://www.boxhero.io/docs/ru/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/ru/developers/api/errors).

> **Note**
>
> Большинство эндпоинтов работают только для команд, которые ведут учёт остатков по [местам хранения](https://www.boxhero.io/docs/ru/concepts/locations). Для остальных команд они возвращают ошибку типа `/errors/invalid-team-mode`. У команды с местами хранения в ответе выше `mode` равно `2`.

## 3. Что дальше

- Получите список остатков с помощью [Список товаров](https://www.boxhero.io/docs/ru/developers/api/reference/items/list-items) и узнайте, как получить все страницы, в разделе [Пагинация](https://www.boxhero.io/docs/ru/developers/api/pagination).
- Записывайте изменения остатков с помощью [Создание операции](https://www.boxhero.io/docs/ru/developers/api/reference/transactions/create-transaction) — правила описаны в разделе [Операции](https://www.boxhero.io/docs/ru/developers/api/reference/transactions).
- Получайте уведомления об изменениях вместо регулярных опросов с помощью [вебхуков](https://www.boxhero.io/docs/ru/developers/webhooks/overview).
- Просмотрите все эндпоинты в [справочнике API](https://www.boxhero.io/docs/ru/developers/api/reference).