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)

El límite de solicitudes se aplica por clave API según su valor almacenado. Las claves nuevas creadas mediante la API usan actualmente 60 solicitudes por minuto, independientemente del plan.

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 60 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