QR-Verse
REST API

API de Código QR para Desenvolvedores

Integre criação, gerenciamento e análise de códigos QR em qualquer aplicação. API JSON RESTful com autenticação por chave API, operações em massa e webhooks em tempo real. De um código único até 500 por solicitação.

POST /api/v1/qr-codes
{ "type": "url", "data": "https://example.com" }

Crie um código QR em segundos

Uma única requisição POST é suficiente. Envie seus dados e obtenha um código QR legível com URL encurtada rastreável e imagem para download.

Requisição
cURL
curl -X POST \
https://qr-verse.com/api/v1/qr-codes \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "url",
"data": "https://example.com",
"style": { "foreground": "#238636" }
}'
Resposta
201 Created
{
"id": "qr_abc123",
"type": "url",
"shortUrl": "https://qr-verse.com/r/abc123",
"image": "https://qr-verse.com/api/v1/qr-codes/qr_abc123/image.svg"
}

Tudo o que você precisa para desenvolver

Uma API completa para gerenciamento do ciclo de vida de códigos QR. Da criação e personalização ao rastreamento de scans e notificações em tempo real.

Operações CRUD completas

Crie, leia, atualize e exclua códigos QR de forma programática. Todos os tipos de QR suportados - URL, vCard, WiFi, email, SMS e mais.

Operações em massa

Crie até 500 códigos QR em uma única requisição API. Ideal para catálogos de e-commerce, ingressos de eventos ou gestão de estoque.

API de Analytics

Recupere dados de scan de forma programática. Total de scans, scans ao longo do tempo, distribuição geográfica, tipos de dispositivos e dados de referência.

Eventos de Webhook

Receba notificações HTTP em tempo real quando seus códigos QR forem escaneados. Acione fluxos de trabalho no seu CRM, analytics ou ferramentas de automação.

Gerenciamento de chaves API

Gere, alterne e revogue chaves API no seu painel. Planos Business suportam múltiplas chaves para diferentes ambientes.

Limitação de taxa

Cabeçalhos claros de limite de taxa em cada resposta. Pro: 100 chamadas/dia. Business: 10.000 chamadas/dia. Nunca fique no escuro sobre sua cota restante.

Acesso a API por plano

O acesso à API começa no Pro. O Business desbloqueia operações em massa, webhooks e 100x o limite diário de chamadas.

Recurso
Free
EUR 0
Pro
EUR 4.99/mo
Business
EUR 12.99/mo
Acesso a API REST
Gerenciamento de chaves API
Criar / Ler / Atualizar / Excluir
Todos os tipos de QR (URL, vCard, WiFi...)
Recuperação de dados de analytics
Chamadas de API por dia010010.000
Operações em massa (por requisição)Até 500
Notificações webhook
Múltiplas chaves API
Respostas de API em marca própria
Docs OpenAPI / Swagger
Comece com o ProComparar todos os planos

Feito para o seu stack

Seja para uma loja online, gerenciamento de pipeline de vendas ou automação de campanhas de marketing - a API QR-Verse se encaixa no seu fluxo de trabalho existente.

Plataformas de e-commerce

Gere códigos QR para cada produto do seu catálogo automaticamente. Vincule a páginas de produto, adicione a embalagens ou incorpore em recibos. Crie em massa 500 códigos por chamada de API para estoques grandes.

Shopify, WooCommerce, ou lojas personalizadas

CRM e ferramentas de vendas

Crie códigos QR personalizados para materiais de vendas, cartões de visita ou portais de clientes. Use webhooks para registrar scans como atividades no CRM e rastrear o engajamento por contato.

HubSpot, Salesforce, Pipedrive

Automação de marketing

Incorpore códigos QR dinâmicos em campanhas de email, anúncios impressos ou materiais de eventos. Recupere analytics de scan via API para medir o ROI da campanha junto com seus dados de marketing existentes.

Mailchimp, ActiveCampaign, Zapier

Experiência do desenvolvedor

Feita por desenvolvedores, para desenvolvedores. Respostas previsíveis, documentação clara e versionamento estável para que você possa publicar com confiança.

Documentação OpenAPI

Especificação completa OpenAPI 3.0 com Swagger UI interativo. Teste endpoints diretamente na documentação. Cada schema de requisição e resposta documentado.

Respostas JSON

Respostas JSON limpas e consistentes com estrutura previsível. Cada endpoint retorna o mesmo formato - objetos de dados, paginação e erros em que você pode confiar.

Tratamento de erros

Respostas de erro estruturadas com códigos de status HTTP, códigos de erro legíveis por máquina e mensagens em linguagem humana. Depure problemas rapidamente sem adivinhar.

Versionamento de API

Endpoints de API versionados (v1) com garantias de compatibilidade retroativa. Mudanças incompatíveis apenas em novas versões principais, para que sua integração permaneça estável.

Endpoints disponíveis
POST/api/v1/qr-codes
GET/api/v1/qr-codes/:id
PATCH/api/v1/qr-codes/:id
DELETE/api/v1/qr-codes/:id
POST/api/v1/qr-codes/bulk
GET/api/v1/qr-codes/:id/analytics

Perguntas frequentes

Qual método de autenticação a API QR-Verse usa?
A API usa autenticação por chave API via tokens Bearer. Inclua sua chave API no cabeçalho Authorization como "Bearer SUA_CHAVE_API". Você pode gerar e gerenciar chaves API no seu painel de conta.
Quais tipos de código QR posso criar pela API?
Todos os tipos de código QR disponíveis na interface web também estão disponíveis via API: URL, vCard (cartões de contato), credenciais de rede WiFi, email, SMS, texto simples e mais. Cada tipo tem seu próprio schema de dados documentado na especificação OpenAPI.
Como funciona a criação em massa de códigos QR?
Usuários do plano Business podem enviar um array de até 500 objetos de código QR em uma única requisição POST ao endpoint de massa. Cada código pode ter tipos, dados e estilos diferentes. A API retorna todos os códigos criados com seus IDs e URLs encurtadas.
O que acontece quando atinjo o limite de taxa?
Cada resposta da API inclui cabeçalhos de limite de taxa: X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Quando você excede seu limite, a API retorna o código de status 429 com o timestamp de reset. Planos Pro obtêm 100 chamadas/dia, planos Business 10.000.
Posso personalizar a aparência dos códigos QR via API?
Sim. A API aceita parâmetros de estilo incluindo cor de primeiro plano, cor de fundo, nível de correção de erros e formato de saída (SVG ou PNG). As mesmas opções de personalização disponíveis no gerador web estão disponíveis pela API.
Como funcionam os webhooks para eventos de scan?
Usuários do plano Business podem registrar URLs de webhook no painel. Quando qualquer código QR seu for escaneado, enviamos uma requisição POST para sua URL de webhook com detalhes do scan: ID do código QR, timestamp, localização (país/cidade), tipo de dispositivo e referência. Webhooks usam assinaturas HMAC para verificação.
A API está disponível no plano gratuito?
Não. O acesso à API requer um plano Pro (EUR 4,99/mês) ou Business (EUR 12,99/mês). O plano gratuito inclui o gerador de QR baseado na web, mas não o acesso programático à API.
Posso recuperar dados de analytics pela API?
Sim. Os planos Pro e Business incluem acesso à API para analytics de scan. Você pode recuperar contagens totais de scans, scans ao longo do tempo (diário/semanal/mensal), distribuição geográfica por país e cidade, tipos de dispositivo e principais referências para qualquer código QR.
Plano Pro necessário

Obtenha sua chave API

Assine um plano Pro ou Business, gere sua chave API no painel e comece a fazer requisições em minutos. Documentação OpenAPI completa incluída.

Comece a desenvolver