Desarrolladores

Construye sobre el cerebro de enrutamiento.

Kilo es API-first en el sentido comprobable: el panel es un cliente de la misma API REST pública que recibes tú, con los mismos alcances y los mismos límites. Si el panel puede hacerlo, tu integración también - crear enlaces y diseños de QR, leer analíticas, gestionar reglas de enrutamiento, todo por HTTP simple.

Qué puedes construir.

Infraestructura de enlaces dentro de tu producto - crea enlaces cortos desde tu backend por registro, campaña o cliente, y deja que el edge responda cada redirección en unos 50 milisegundos.

Flujos de QR para imprenta - crea un enlace y guarda su diseño de QR en un solo flujo, para que cada cartel, carta y paquete lleve un código que puedes redirigir después de imprimir.

Informes que cuadran con el panel - lleva totales, series temporales, países, dispositivos y calidad de clics a tu propio almacén o a los informes de tus clientes. Mismos endpoints, mismos números.

Flujos con asistentes de IA - conecta Claude, Cursor o cualquier cliente MCP al servidor MCP alojado y maneja la misma API en conversación normal.

Crea un enlace en sesenta segundos.

Crea una clave de API en el panel, en API keys - read para informes, read + write para crear cosas. La clave en claro se muestra exactamente una vez. Con la clave en la mano, una llamada crea un enlace:

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" }'

La respuesta 201 trae tu slug - el enlace está vivo en qr2r.com/<slug> desde ese momento, y su destino puede redirigirse más tarde sin cambiar nada de lo que imprimiste o enviaste.

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

Desde aquí, la guía de la API cubre autenticación, alcances, la forma de los errores y los límites de tasa; enlaces y analíticas + reglas recorren cada llamada con un ejemplo de curl.

La superficie para desarrolladores.

Cinco recursos, una API. La referencia interactiva y la especificación legible por máquinas se generan de los mismos esquemas contra los que valida el Worker, así que ninguno puede desalinearse.

Con qué puedes contar.

  • Redirecciones en el edge.

    Un enlace se resuelve en el edge de Cloudflare en unos 50 milisegundos. Las analíticas y todo lo más pesado corren fuera de ese camino - nunca delante de tu visitante.

  • Errores honestos, límites declarados.

    Cada error es JSON con un solo campo error y un código de estado documentado; el límite de tasa responde 429 con un retry_after. Los límites están declarados en la guía, no se descubren en producción.

  • Un contrato que se sostiene.

    El panel corre sobre estos mismos endpoints, así que un cambio incompatible rompería primero a Kilo - la garantía de estabilidad más fuerte que una plataforma puede ofrecer con honestidad.

Construye algo encima.

Crear una clave de API