Documentación de la API

Crea códigos QR y códigos de barras desde tu producto con una API REST. Envía JSON a /api/v1, recibe el arte SVG alojado y luego lista o actualiza esos mismos recursos.

Crear un código QR

POST /api/v1/qr-codes con un type, contenido y diseño opcional: colores, estilo de módulo, logo, ojos y marco. La respuesta incluye una URL SVG alojada.

{
  "name": "Website QR",
  "type": "url",
  "url": "https://forqrcode.com",
  "style": "rounded",
  "size": 500,
  "ecc": "M",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "qr_code_logo": "https://forqrcode.com/logo.png",
  "qr_code_logo_size": 25
}
Referencia de creación de QR

Crear un código de barras

POST /api/v1/barcodes con una simbología, value y colores o tamaño opcionales. Hay treinta y cuatro tipos, de Code 128 a EAN-13.

{
  "name": "Product SKU",
  "type": "C128",
  "value": "FORQR-1001",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "width_scale": 2,
  "height": 80,
  "display_text": true
}
Referencia de creación de código de barras

Autenticación

Envía tu clave API como token Bearer en cada solicitud. Puedes verla o regenerarla en Panel → Cuenta → API.

Authorization: Bearer YOUR_API_KEY

URL base: https://forqrcode.com/api/v1

Límites de velocidad

Cada clave API está limitada a 60 solicitudes por minuto. Las respuestas incluyen las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset.

Errores

Los errores usan un formato JSON:API:

{ "errors": [{ "title": "…", "status": "422" }] }

Los errores de validación pueden incluir source.pointer.