Documentação da API

Operações em Lote

Criação em Lote de Códigos QR

Automatize a criação de seus códigos QR com nossa API. Crie centenas ou milhares de códigos QR de uma vez, perfeito para grandes campanhas, rotulagem de produtos ou rastreamento de ativos.

Importação CSV

Carregue um arquivo CSV com seus dados de código QR e criaremos todos de uma vez.

Lote da API

Crie vários códigos QR em uma única chamada de API com carga JSON.

Processamento Assíncrono

Grandes importações são executadas em segundo plano com rastreamento de status.

Endpoints

Método	Endpoint	Descrição
POST	/organizations/:orgId/qr-codes/bulk-import	Iniciar uma importação em lote a partir de CSV
GET	/organizations/:orgId/qr-codes/bulk-import	Listar todos os trabalhos de importação
GET	/organizations/:orgId/qr-codes/bulk-import/:id	Obter status do trabalho de importação
GET	/organizations/:orgId/qr-codes/bulk-import/sample	Baixar modelo CSV
POST	/organizations/:orgId/qr-codes/batch/update	Atualizar em lote vários códigos QR
POST	/organizations/:orgId/qr-codes/batch/clone	Clonar vários códigos QR
DELETE	/organizations/:orgId/qr-codes/batch	Excluir vários códigos QR

Importação em Lote CSV

A maneira mais fácil de criar muitos códigos QR de uma vez é via importação CSV. Siga estas etapas:

Baixar o modelo CSV

Obtenha o modelo para o seu tipo de código QR para garantir a formatação correta.

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/sample?type=URL" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o template.csv

Preencha seus dados

Adicione seus dados de código QR ao arquivo CSV. Aqui está um exemplo para códigos QR de URL:

url_qr_codes.csv

name,url,folder,tags
Homepage QR,https://example.com,Marketing,homepage;main
Product Page,https://example.com/product,Products,product;featured
Contact Us,https://example.com/contact,Marketing,contact;support
Promo Landing,https://example.com/promo,Campaigns,promo;summer2024

Carregar o arquivo CSV

Envie o arquivo para iniciar o trabalho de importação.

Iniciar Importação

curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@url_qr_codes.csv" \
  -F "type=URL"

Monitorar o progresso da importação

Verifique o status do seu trabalho de importação.

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/import_abc123" \
  -H "X-API-Key: YOUR_API_KEY"

Resposta

{
  "id": "import_abc123",
  "status": "COMPLETED",
  "type": "URL",
  "totalRows": 100,
  "processedRows": 100,
  "successCount": 98,
  "errorCount": 2,
  "errors": [
    { "row": 45, "error": "Invalid URL format" },
    { "row": 72, "error": "Name is required" }
  ],
  "createdAt": "2024-01-15T10:00:00Z",
  "completedAt": "2024-01-15T10:02:30Z"
}

Referência de Coluna CSV

Cada tipo de QR code requer colunas diferentes. Aqui estão as mais comuns:

QR Codes de URL

Coluna	Requerido	Descrição
name	Requerido	Nome exibido para o QR code
url	Requerido	URL de destino (deve começar com http:// ou https://)
folder	Opcional	Nome da pasta para organizar o QR code
tags	Opcional	Tags separadas por ponto e vírgula

QR Codes vCard

Coluna	Requerido	Descrição
name	Requerido	Nome exibido para o QR code
firstName	Requerido	Primeiro nome do contato
lastName	Requerido	Último nome do contato
email	Opcional	Endereço de e-mail
phone	Opcional	Número de telefone
company	Opcional	Nome da empresa
title	Opcional	Cargo

Atualização em Lote

Atualize múltiplos QR codes de uma vez com uma única chamada de API.

POST

/organizations/:orgId/qr-codes/batch/update

Solicitação de Atualização em Lote

curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/batch/update" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["qr_abc123", "qr_def456", "qr_ghi789"],
    "updates": {
      "folderId": "folder_xyz",
      "style": {
        "foregroundColor": "#1D59F9"
      }
    }
  }'

Limites de Importação

Máximo de Linhas

10,000

QR codes por arquivo CSV

Limite de Tamanho de Arquivo

10 MB

Tamanho máximo do arquivo CSV

Dica: Para importações muito grandes (10.000+ QR codes), considere dividir seu CSV em vários arquivos e importá-los sequencialmente.

Casos de Uso

Rotulagem de Produtos

Gere QR codes únicos para cada produto em seu inventário

Campanhas de Marketing

Crie QR codes personalizados para cada destinatário

Rastreamento de Ativos

Rotule equipamentos, documentos ou ativos físicos

Gerenciamento de Eventos

Gere ingressos ou crachás com QR codes únicos

Próximos Passos

Saiba mais sobre recursos relacionados: