API REST

Cree, edite y mida sus códigos QR desde sus propias herramientas. Disponible a partir del plan Pro.

Autenticación

Cada espacio de trabajo puede crear claves API desde sus ajustes. La clave solo se muestra una vez. Envíela en la cabecera Authorization.

curl -H "Authorization: Bearer sc_xxxxxxxx…" https://www.scanolo.com/api/v1/codes

Puntos de acceso

Método	Ruta	Descripción
`GET`	`/api/v1/codes`	Lista de los códigos del espacio de trabajo (paginada).
`POST`	`/api/v1/codes`	Crea un código. Cuerpo JSON: name, kind, mode, payload, design.
`GET`	`/api/v1/codes/{id}`	Detalle de un código, dirección corta incluida.
`PATCH`	`/api/v1/codes/{id}`	Edita el nombre, el destino, el diseño o el estado.
`DELETE`	`/api/v1/codes/{id}`	Elimina un código (deja de redirigir tras una confirmación explícita).
`GET`	`/api/v1/codes/{id}/image.svg`	Imagen del código en SVG o PNG (parámetro size para el PNG).
`GET`	`/api/v1/codes/{id}/stats`	Estadísticas de escaneos entre dos fechas.
`POST`	`/api/v1/render`	Renderizado de un código estático sin almacenarlo.

Ejemplo

curl -X POST https://www.scanolo.com/api/v1/codes \
  -H "Authorization: Bearer sc_xxxxxxxx…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Menu terrasse", "kind": "url", "mode": "dynamic",
       "payload": {"url": "https://example.com/menu"},
       "design": {"fg": "#10211F", "module": "rounded"}}'

{"id": 42, "slug": "k7Hp3Qz", "short_url": "https://www.scanolo.com/r/k7Hp3Qz",
 "kind": "url", "mode": "dynamic", "status": "active", "safety_status": "safe",
 "scans_total": 0, "created_at": "2026-09-06T10:00:00Z"}

Límites

Pro: 60 peticiones por minuto. Business: 300. Por encima, la respuesta es 429 con una cabecera Retry-After. Las cuotas de códigos dinámicos del plan también se aplican por API.

Obtener una clave API