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

# Inicio rápido

> Genere un token de API y realice su primera solicitud a la API de BoxHero.

Esta guía lo lleva desde no tener ningún token hasta su primera llamada exitosa a la API.

## 1. Genere un token de API

En la app web de escritorio, abra el equipo que desea conectar y vaya a `Configuración` > `Integraciones y API`. Genere un nuevo token de API y cópielo.

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

> **Caution**
>
> **Nota**: Un token está vinculado al equipo en el que se generó y da acceso completo a los datos de ese equipo a través de la API. Guárdelo en su servidor; nunca lo incluya en una app móvil, en código del navegador ni en un repositorio público.

## 2. Realice su primera solicitud

Llame a [Get the linked team](https://www.boxhero.io/docs/es/developers/api/reference/teams/get-linked-team) para comprobar que el token funciona. Envíe el token en el encabezado `Authorization`:

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

La respuesta describe el equipo al que pertenece el token:

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

Si en cambio recibe un `401`, falta el token o se copió de forma incompleta. Consulte [Errores](https://www.boxhero.io/docs/es/developers/api/errors) para ver el formato de los errores.

> **Note**
>
> La mayoría de los endpoints solo funcionan para equipos que gestionan las existencias por [ubicación](https://www.boxhero.io/docs/es/concepts/locations). Para otros equipos devuelven un error de tipo `/errors/invalid-team-mode`. En un equipo por ubicación, `mode` vale `2` en la respuesta anterior.

## 3. Próximos pasos

- Liste su inventario con [List items](https://www.boxhero.io/docs/es/developers/api/reference/items/list-items) y aprenda a obtener todas las páginas en [Paginación](https://www.boxhero.io/docs/es/developers/api/pagination).
- Registre cambios de existencias con [Create a transaction](https://www.boxhero.io/docs/es/developers/api/reference/transactions/create-transaction); consulte [Transactions](https://www.boxhero.io/docs/es/developers/api/reference/transactions) para conocer las reglas.
- Reciba notificaciones de los cambios en lugar de consultar periódicamente con los [webhooks](https://www.boxhero.io/docs/es/developers/webhooks/overview).
- Explore todos los endpoints en la [referencia de la API](https://www.boxhero.io/docs/es/developers/api/reference).