Pular para o conteúdo

Autenticação

Autentique as requisições à API do BoxHero com um token Bearer e envie-as para a URL base com versão.


Toda requisição deve levar um token de API como token Bearer no cabeçalho Authorization:

Authorization: Bearer <api-token>

Emita tokens no app BoxHero em Configurações > Integrações e API. Cada token está vinculado a uma única equipe: toda requisição lê e grava somente os dados dessa equipe. Para trabalhar com várias equipes, emita um token em cada uma delas.

O acesso anônimo não é permitido. Quando o token está ausente ou é inválido, todos os endpoints retornam 401 com um envelope de erro.

Todas as requisições vão para:

https://rest.boxhero-app.com

Todos os endpoints ficam sob o prefixo /v1 — por exemplo, GET /v1/items.