Ir al contenido

Autenticación

Autentique las solicitudes a la API de BoxHero con un token Bearer y envíelas a la URL base con versión.

Cada solicitud debe incluir un token de API como token Bearer en el encabezado Authorization:

Authorization: Bearer <api-token>

Genere tokens en la app de BoxHero en Configuración > Integraciones y API. Cada token está vinculado a un único equipo: cada solicitud lee y escribe solo los datos de ese equipo. Para trabajar con varios equipos, genere un token en cada uno de ellos.

No se admite el acceso anónimo. Si falta el token o no es válido, todos los endpoints devuelven 401 con un objeto de error.

Todas las solicitudes se envían a:

https://rest.boxhero-app.com

Todos los endpoints se encuentran bajo el prefijo /v1; por ejemplo, GET /v1/items.

La mayoría de los endpoints solo están disponibles para equipos que gestionan las existencias por ubicación. Para otros equipos devuelven 400 con el tipo de error /errors/invalid-team-mode. Los endpoints de equipos, miembros, socios y atributos funcionan para todos los equipos; llame a Get the linked team para ver qué modo usa su equipo.