Documentação da API

Crie QR codes e códigos de barras a partir do seu produto com uma API REST. Envie JSON para /api/v1, receba arte SVG hospedada e depois liste ou atualize os mesmos recursos.

Criar um QR code

POST /api/v1/qr-codes com type, conteúdo e design opcional: cores, estilo de módulo, logo, olhos e moldura. A resposta inclui uma URL SVG hospedada.

{
  "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
}
Referência de criação de QR

Criar um código de barras

POST /api/v1/barcodes com uma simbologia, value e cores ou tamanho opcionais. Há trinta e quatro 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
}
Referência de criação de código de barras

Autenticação

Envie sua chave de API como Bearer em cada requisição. Veja ou regenere em Painel → Conta → API.

Authorization: Bearer YOUR_API_KEY

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

Limites de taxa

Cada chave permite 60 requisições por minuto. Respostas incluem X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset.

Erros

Os erros seguem o formato JSON:API:

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

Erros de validação podem incluir source.pointer.