Documentação da API

Operações em Lote

Criar QR Codes em Massa

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

Importação CSV

Faça o upload de um arquivo CSV com seus dados de QR code e nós os criaremos todos de uma vez.

API Batch

Crie múltiplos códigos QR em uma única chamada de API com carga útil JSON.

Processamento Assíncrono

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

Pontos finais

Método	Ponto final	Descrição
POST	/organizations/:orgId/qr-codes/bulk-import	Iniciar uma importação em massa a partir de CSV
GET	/organizations/:orgId/qr-codes/bulk-import	Liste todos os empregos 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	Atualização em lote de vários QR codes
POST	/organizations/:orgId/qr-codes/batch/clone	Clone múltiplos QR codes
DELETE	/organizations/:orgId/qr-codes/batch	Excluir vários códigos QR

Importação em Massa de CSV

A maneira mais fácil de criar muitos códigos QR de uma só vez é através da importação de CSV. Siga estes passos:

Baixe 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 do QR code ao arquivo CSV. Aqui está um exemplo para QR codes 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

Faça o upload do 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 código QR requer colunas diferentes. Aqui estão as mais comuns:

Códigos QR de URL

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

Códigos QR vCard

Coluna	Requerido	Descrição
name	Requerido	Nome a ser exibido para o código QR
firstName	Requerido	Nome do contato
lastName	Requerido	Sobrenome do contato
email	Opcional	Endereço de e-mail
phone	Opcional	Número de telefone
company	Opcional	Nome da empresa
title	Opcional	Título do trabalho

Atualização em Lote

Atualize vários códigos QR de uma só 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

Linhas Máximas

10,000

Códigos QR por arquivo CSV

Limite de Tamanho de Arquivo

10 MB

Tamanho máximo do arquivo CSV

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

Casos de Uso

Rotulagem de Produtos

Gere códigos QR únicos para cada produto em seu inventário

Campanhas de Marketing

Crie códigos QR personalizados para cada destinatário

Rastreamento de Ativos

Rotule equipamentos, documentos ou ativos físicos

Gestão de Eventos

Gere ingressos ou crachás com códigos QR exclusivos

Próximos Passos

Saiba mais sobre recursos relacionados: