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.

2. Faça sua primeira requisição

Chame Obter a equipe vinculada para verificar se o token funciona. Envie o token no cabeçalho Authorization:

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

A resposta descreve a equipe à qual o token pertence:

{
  "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 para conhecer o formato de erro.

3. Próximos passos

Liste o seu estoque com Listar itens e aprenda a buscar todas as páginas em Paginação.
Registre alterações de estoque com Criar uma transação — consulte Transações para conhecer as regras.
Receba notificações de alterações em vez de fazer consultas periódicas com os Webhooks.
Navegue por todos os endpoints na Referência da API.