API v1 · Business

Documentación API

La API REST iziqrcode permite crear, gestionar y rastrear sus códigos QR por programación.

Base URL

Todos los endpoints están disponibles en:

https://iziqrcode.com/api/v1

Autenticación

La API usa tokens Bearer. Genere su clave desde /app/api-keys e inclúyala en la cabecera Authorization:

curl https://iziqrcode.com/api/v1/qr \
  -H "Authorization: Bearer izi_live_xxxxx..."

Formato de las respuestas

La API devuelve JSON en cada respuesta. Códigos de estado HTTP estándar:

2xxÉxito — la solicitud se ha procesado
4xxError de cliente — revise su solicitud
5xxError de servidor — vuelva a intentarlo más tarde

Rate limiting

3 ventanas deslizantes por clave / cuenta:

  • 60 solicitudes / minuto por clave API
  • 5.000 solicitudes / hora por clave API
  • 5.000 solicitudes / día por cuenta

Cada respuesta incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset. Se devuelve un 429 Too Many Requests con una cabecera Retry-After en cuanto se alcanza el límite.

Especificación OpenAPI

Especificación legible por máquina en /api/v1/openapi — importable en Postman / Insomnia / openapi-typescript. El visor Swagger interactivo está en /api-docs.

Documentación API · iziqrcode