curto.me
Entrar

API REST do curto.me

Gere QR Code PIX (estático e cobrança), encurte URLs e gere QR de Wi-Fi, vCard, texto, geo, evento, contato e WhatsApp via API REST. 10 endpoints, Bearer token, 1000 requests por dia grátis — sem cartão.

Criar API key grátisDocumentação interativa

O que você pode fazer

  • QR Code PIX

    Estático (sem valor fixo) ou cobrança (com valor). EMV-compliant, todos os bancos BR aceitam.

    POST /api/v1/qr-pix · POST /api/v1/qr-pix-cobranca

  • Encurtador de URL

    Link longo vira curto.me/xxxxx. Resposta inclui short_code, short_url e QR Code do link.

    POST /api/v1/shorten

  • QR de Wi-Fi

    Cliente conecta na rede sem digitar senha. Suporta WPA/WPA2/WPA3, WEP e rede aberta.

    POST /api/v1/qr-wifi

  • QR de contato

    vCard e MeCard pra cartão de visita digital. Nome, telefone, email, empresa, site.

    POST /api/v1/qr-vcard · POST /api/v1/qr-contato

  • QR de evento

    Adiciona compromisso no calendário do convidado (Google/Apple Calendar). Data, hora, local, descrição.

    POST /api/v1/qr-evento

  • QR de texto, geo, WhatsApp

    Texto livre, coordenadas que abrem no Maps, mensagem pronta no WhatsApp.

    POST /api/v1/qr-texto · /qr-geo · /qr-whatsapp

Comece em 1 minuto

1. Crie uma API key (precisa estar logado — login por email, sem senha).

2. Faça a primeira chamada:

curl -X POST https://curto.me/api/v1/qr-pix \
  -H "Authorization: Bearer cme_sua_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "pix_key": "[email protected]",
    "merchant_name": "LOJA",
    "merchant_city": "BRASILIA"
  }'

3. Resposta:

{
  "public_id": "01J9Z3K8...",
  "type": "qr_pix_static",
  "br_code": "00020126360014BR.GOV.BCB.PIX...",
  "image_url": "https://curto.me/qr/pix-static/01J9Z3K8....png",
  "svg_url": "https://curto.me/qr/pix-static/01J9Z3K8....svg",
  "detail_url": "https://curto.me/qr-pix/01J9Z3K8...",
  "created_at": "2026-05-17T12:00:00-03:00"
}

Preços e limites

Free

R$ 0

  • ✓ 1000 requests/dia/key
  • ✓ 3 keys por conta
  • ✓ Todos os 10 endpoints
  • ✓ Sem cartão de crédito
  • ✓ Sem expiração

Volume / B2B

Sob demanda

  • · Volume maior que 1000/dia
  • · SLA contratual
  • · Revenda B2B2C (white-label)
  • · Faturado mensal

Email: [email protected]

Perguntas frequentes

  • O que é a API do curto.me?

    É uma API REST pública pra integrar curto.me em qualquer sistema — gera QR Code PIX (estático e cobrança), encurta URLs e gera QR de Wi-Fi, vCard, texto, geolocalização, evento, contato e WhatsApp. Mesma engine que serve o site, exposta via 10 endpoints simples com Bearer token.

  • Quanto custa?

    Grátis no tier inicial — 1000 requests por dia por API key, sem cartão de crédito, sem expiração. Você cria a key em /conta/api depois de fazer login. Se passar do limite, manda email pra [email protected] e a gente fecha um plano sob medida (ainda não tem tabela pública porque preferimos negociar caso a caso enquanto a base é pequena).

  • Preciso de cartão pra criar API key?

    Não. Cadastro é por email (magic link, sem senha) e a key é gratuita imediatamente — sem cartão, sem trial. Você pode integrar em produção no mesmo dia.

  • Posso usar em produção?

    Sim. A API roda na mesma infra que serve o curto.me — Cloudflare na borda, FrankenPHP + PostgreSQL no origin (VPS Hetzner). Há rate-limit por key, mas sem SLA contratual formal no tier grátis. Pra workload crítico com SLA, fale com a gente.

  • Tem limite por minuto ou só por dia?

    Hoje o único limite é 1000 requests/dia/key (janela rolling 24h). Não há rate-limit por segundo no tier grátis — se você precisa de burst, fica à vontade dentro da cota diária. Se virar problema operacional, pode ser adicionado depois.

  • O que volta no response?

    JSON com public_id, type, image_url (PNG), svg_url (quando disponível — PIX tem nativo), detail_url (página do artefato no site), créditos type-specific (br_code pra PIX, short_url pra encurtador, etc) e created_at em ISO 8601. Veja exemplos completos em /api/docs.

  • Vocês têm SDK em alguma linguagem?

    Ainda não — a API é REST padrão, qualquer cliente HTTP serve (curl, fetch, axios, requests, Guzzle). Como tem OpenAPI spec em /api/openapi.json, dá pra gerar SDK automaticamente em qualquer linguagem com openapi-generator. Quando demanda concreta justificar, avaliamos SDKs nativos.

  • Funciona com Zapier, n8n, Make ou Bubble?

    Sim. Qualquer plataforma low-code/no-code que suporte HTTP request com header Authorization Bearer funciona — Zapier "Webhooks", n8n "HTTP Request", Make "HTTP", Bubble "API Connector". É só apontar pra https://curto.me/api/v1/<endpoint> e passar a key.

  • Posso revender pros meus clientes (B2B2C)?

    Sim no tier grátis pra projetos pequenos. Pra revenda como produto white-label de fato (múltiplos clientes finais, branding próprio), o caminho é o futuro tier "agency" — ainda não está aberto, mas se você esbarrar no limite e precisar de planos maiores, mande email pra [email protected] com volume estimado.

  • Qual a diferença pra bit.ly, encurtador.com.br ou outros?

    Encurtadores tradicionais focam só em URL → URL curta. curto.me é uma plataforma completa de QR: PIX estático e cobrança, Wi-Fi, vCard, geolocalização, evento, contato, WhatsApp. Tudo via 10 endpoints na mesma API com a mesma key. E é brasileiro, pt-BR, LGPD nativo, com QR PIX EMV-compliant que os bancos BR aceitam.

  • Como faço pra subir o limite?

    Não temos auto-upgrade no painel ainda — é manual: mande email pra [email protected] com seu caso de uso, volume esperado e se precisa de SLA. A gente fecha um plano sob medida conforme volume e caso de uso.

  • A API guarda meus dados? E os dados dos meus usuários finais?

    Guarda os artefatos que você cria (vinculados à sua conta) — você pode listar, baixar de novo e deletar. IPs entram apenas como hash HMAC (ADR 0018), nunca em texto claro. Detalhes completos na Política de Privacidade. Se você usa pra gerar QR PIX dos seus clientes, a chave PIX é gravada no artefato — leia a política antes de integrar dados sensíveis de terceiros.

Outras ferramentas grátis no curto.me