> For the complete documentation index, see [llms.txt](https://developers.lockerhaus.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.lockerhaus.com/inicio/readme.md).

# Documentación de la API de Lockerhaus

Bienvenido a la referencia de la **API de Lockerhaus**. Esta API permite a integradores y socios (por ejemplo, Shopperhaus) gestionar usuarios, lockers, paquetes y envíos de forma programática.

## URL base

```
https://app.lockerhaus.com/api
```

## Autenticación

La mayoría de los endpoints requieren la **API key del cliente** en el header `x-api-key`. Los endpoints que operan sobre el usuario autenticado requieren además un **token Bearer** obtenido en `POST /login`.

| Esquema              | Header                          | Uso                                                                   |
| -------------------- | ------------------------------- | --------------------------------------------------------------------- |
| API key              | `x-api-key: <tu-api-key>`       | Identifica al cliente/partner. Requerido en casi todos los endpoints. |
| Bearer (usuario)     | `Authorization: Bearer <token>` | Token del usuario autenticado, devuelto por `POST /login`.            |
| Bearer (integración) | `Authorization: Bearer <token>` | Token propio para los endpoints de ingesta de paquetes.               |

## APIs disponibles

En el menú lateral vas a encontrar dos APIs:

* **Lockerhaus API** — para integradores/partners: autenticación, lockers y precios, usuario, paquetes, ubicaciones, cupones y estado. URL base `https://app.lockerhaus.com/api`.
* **Shopperhaus — Couriers** — para couriers partner que reciben productos y los envían al destino final: perfil, cobertura, tarifas por destino, envíos y liquidaciones. Auth con `x-api-key` + `x-api-secret`. Ver [Introducción](/shopperhaus-couriers/introduccion.md).

> Estas referencias documentan únicamente la superficie pública/partner. Los endpoints internos del panel de administración no están incluidos.