> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://api.herramientas.lat/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api.herramientas.lat/_mcp/server.

# Autenticación

> API keys y scopes de herramientas.lat

# Autenticación

Todas las rutas bajo `/api/v1` requieren:

```http
Authorization: Bearer hl_tu_api_key
```

## Crear una key

1. Entrá a [herramientas.lat/cuenta/api](https://herramientas.lat/cuenta/api)
2. Elegí un nombre y los scopes
3. Copiá el secreto **una sola vez** (después solo ves el prefijo)

## Scopes

| Scope      | Permite                                  |
| ---------- | ---------------------------------------- |
| `qr:read`  | Listar QRs, detalle y métricas           |
| `qr:write` | Crear, actualizar, pausar y eliminar QRs |

`qr:write` implica también lectura sobre recursos QR.

## Ejemplo

```bash
curl https://www.herramientas.lat/api/v1/qr \
  -H "Authorization: Bearer hl_..."
```

Sin key o con key inválida → `401`. Scope insuficiente → `403`.