Autenticación

Autenticación

qr3.app utiliza claves de API (Bearer tokens) para la autenticación. No hay flujos de OAuth: simplemente genera una clave y úsala de inmediato.

Crear una clave de API

1. Inicia sesión en app.qr3.app
2. Ve a Configuración → Claves de API
3. Haz clic en Nueva clave
4. Selecciona los permisos (scopes) deseados
5. Copia la clave: ¡solo se mostrará una vez!

Tipos de claves

Tipo	Prefijo	Uso
Secret Key	qr3_sk_	Lado del servidor (API, backend)
Publishable Key	qr3_pk_	Lado del cliente (solo lectura)
Test Key	qr3_test_sk_	Desarrollo (límites de velocidad propios)

Precaución

Las Secret Keys (qr3_sk_) nunca deben utilizarse en el frontend o en código del lado del cliente.

Uso

Cabecera HTTP

Authorization: Bearer qr3_sk_your_key_here

cURL

curl https://qr3.app/v1/codes \
  -H "Authorization: Bearer qr3_sk_your_key_here"

TypeScript SDK

import { QR3 } from "@qr3/sdk";

const client = new QR3({ apiKey: "qr3_sk_your_key_here" });
const codes = await client.codes.list();

CLI

qr3 login
# oder:
export QR3_API_KEY=qr3_sk_your_key_here

Límites de velocidad (Rate Limits)

Plan	Solicitudes/Minuto	Cabeceras de respuesta
Gratuito	30	X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Pro	120	←
Business	300	←
Agency	600	←

Si se excede el límite, la API devuelve HTTP 429:

{
  "type": "https://docs.qr3.app/errors/rate-limited",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit of 30 requests/minute exceeded"
}

Ámbitos (Scopes)

Scope	Descripción
*	Acceso completo
codes:read	Leer códigos QR
codes:write	Crear y editar códigos QR
scans:read	Leer estadísticas de escaneo
webhooks:write	Configurar webhooks
account:read	Leer información de la cuenta