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

# Início rápido

> Emita um token de API e faça sua primeira requisição à API do BoxHero.

Este guia leva você do zero, sem token, até a sua primeira chamada bem-sucedida à API.

## 1. Emita um token de API

No app web para desktop, abra a equipe que você quer conectar e acesse `Configurações` > `Integrações e API`. Gere um novo token de API e copie-o.

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

> **Caution**
>
> **Observação**: o token está vinculado à equipe em que foi emitido e dá acesso total aos dados dessa equipe pela API. Mantenha-o no seu servidor — nunca o coloque em um app para celular, em código de navegador ou em um repositório público.

## 2. Faça sua primeira requisição

Chame [Obter a equipe vinculada](https://www.boxhero.io/docs/pt/developers/api/reference/teams/get-linked-team) para verificar se o token funciona. Envie o token no cabeçalho `Authorization`:

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

A resposta descreve a equipe à qual o token pertence:

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

Se você receber um `401`, o token está ausente ou foi copiado de forma incompleta. Consulte [Erros](https://www.boxhero.io/docs/pt/developers/api/errors) para conhecer o formato de erro.

> **Note**
>
> A maioria dos endpoints funciona apenas para equipes que gerenciam o estoque por [local](https://www.boxhero.io/docs/pt/concepts/locations). Para as demais equipes, eles retornam um erro do tipo `/errors/invalid-team-mode`. Uma equipe com locais tem `mode` definido como `2` na resposta acima.

## 3. Próximos passos

- Liste o seu estoque com [Listar itens](https://www.boxhero.io/docs/pt/developers/api/reference/items/list-items) e aprenda a buscar todas as páginas em [Paginação](https://www.boxhero.io/docs/pt/developers/api/pagination).
- Registre alterações de estoque com [Criar uma transação](https://www.boxhero.io/docs/pt/developers/api/reference/transactions/create-transaction) — consulte [Transações](https://www.boxhero.io/docs/pt/developers/api/reference/transactions) para conhecer as regras.
- Receba notificações de alterações em vez de fazer consultas periódicas com os [Webhooks](https://www.boxhero.io/docs/pt/developers/webhooks/overview).
- Navegue por todos os endpoints na [Referência da API](https://www.boxhero.io/docs/pt/developers/api/reference).