Desenvolvedores

Construa sobre o cérebro de roteamento.

A Kilo é API-first no sentido verificável: o painel é um cliente da mesma API REST pública que você recebe, com os mesmos escopos e os mesmos limites. Se o painel consegue fazer, a sua integração também - criar links e designs de QR, ler análises, gerenciar regras de roteamento, tudo por HTTP simples.

O que você pode construir.

Infraestrutura de links dentro do seu produto - crie links curtos do seu backend por cadastro, campanha ou cliente, e deixe a borda responder cada redirecionamento em cerca de 50 milissegundos.

Fluxos de QR para impressão - crie um link e salve o design do QR em um fluxo só, para que cada cartaz, cardápio e embalagem carregue um código que você pode redirecionar depois de imprimir.

Relatórios que batem com o painel - leve totais, séries temporais, países, dispositivos e qualidade de cliques para o seu próprio warehouse ou para relatórios de clientes. Mesmos endpoints, mesmos números.

Fluxos com assistentes de IA - conecte o Claude, o Cursor ou qualquer cliente MCP ao servidor MCP hospedado e conduza a mesma API em conversa comum.

Crie um link em sessenta segundos.

Crie uma chave de API no painel, em API keys - read para relatórios, read + write para criar coisas. A chave em texto claro aparece exatamente uma vez. Com a chave em mãos, uma chamada cria um link:

POST /api/links
curl https://qr2r.com/api/links \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "default_target": "https://example.com/landing", "name": "Spring flyer" }'

A resposta 201 traz o seu slug - o link está no ar em qr2r.com/<slug> a partir desse momento, e o destino pode ser redirecionado depois sem mudar nada do que você imprimiu ou enviou.

201 Created
{
  "slug": "aA3k9",
  "name": "Spring flyer",
  "default_target": "https://example.com/landing",
  "disabled": false,
  "created_at": 1719000000000
}

A partir daqui, o guia da API cobre autenticação, escopos, o formato dos erros e os limites de taxa; links e análises + regras percorrem cada chamada com um exemplo de curl.

A superfície para desenvolvedores.

Cinco recursos, uma API. A referência interativa e a especificação legível por máquina são geradas dos mesmos esquemas contra os quais o Worker valida - nada disso pode desalinhar.

Com o que você pode contar.

  • Redirecionamentos na borda.

    Um link se resolve na borda da Cloudflare em cerca de 50 milissegundos. As análises e tudo que é mais pesado rodam fora desse caminho - nunca na frente do seu visitante.

  • Erros honestos, limites declarados.

    Todo erro é JSON com um único campo error e um código de status documentado; o limite de taxa responde 429 com um retry_after. Os limites estão declarados no guia, não são descobertos em produção.

  • Um contrato que se sustenta.

    O painel roda nesses mesmos endpoints, então uma mudança incompatível quebraria a Kilo primeiro - a garantia de estabilidade mais forte que uma plataforma pode oferecer com honestidade.

Construa algo em cima.

Criar uma chave de API