API de Krows: primeros pasos

Capítulo 1Visión general

La API de Krows es una API REST, en inglés, con respuestas JSON, pensada como la de Stripe. Con ella creas sesiones de checkout desde tu servidor, lees tu ronda, tus inversiones, tus hitos y recompensas, y consultas los eventos. Los webhooks te avisan de lo que pasa sin tener que preguntar.

Capítulo 2Las claves

app.krows.app/proyectos/gueepard/integrar

123

1. Ve a tu startup › Integración › API para tu appO al panel › API y webhooks.
2. Pulsa «Crear clave secreta»Cópiala y guárdala en un lugar seguro (variable de entorno). Por seguridad no la volverás a ver: si la pierdes, regénérala.
3. Regenerar la invalida al momento. Hazlo si se filtra.

Capítulo 3Tu primera llamada

Lee tu ronda. Con sk_test todo ocurre en modo prueba.

curl https://xvxhouuprjsmpfiwxkzz.supabase.co/functions/v1/api/v1/round \
  -H "Authorization: Bearer $KROWS_SECRET_KEY"

const res = await fetch('https://xvxhouuprjsmpfiwxkzz.supabase.co/functions/v1/api/v1/round', {
  headers: { Authorization: `Bearer ${process.env.KROWS_SECRET_KEY}` },
});
const round = await res.json();
console.log(round.raised, round.goal, round.status);

import os, requests

r = requests.get("https://xvxhouuprjsmpfiwxkzz.supabase.co/functions/v1/api/v1/round",
                 headers={"Authorization": f"Bearer {os.environ['KROWS_SECRET_KEY']}"})
round = r.json()
print(round["raised"], round["goal"], round["status"])

{
  "object": "round",
  "mode": "live",
  "startup": { "name": "Aurora Solar", "slug": "aurora-solar" },
  "status": "open",
  "goal": 120000,
  "raised": 46800,
  "currency": "USDC",
  "percent_raised": 39,
  "investors": 90,
  "tokens": 120000,
  "token_price": 1,
  "start": "2026-10-03T00:00:00.000Z",
  "end": "2027-01-15T00:00:00.000Z",
  "contract": "9fQk…",
  "network": "mainnet"
}

La primera llamada correcta marca la integración «API» como detectada en Integración, en el modo de la clave.

Capítulo 4Paginación, idempotencia y errores

Paginación

Las listas devuelven {"object": "list", "data": [...], "has_more": true|false}. Usa limit (1–100, por defecto 20) y starting_after con el id del último elemento.

curl "https://xvxhouuprjsmpfiwxkzz.supabase.co/functions/v1/api/v1/investments?limit=20" \
  -H "Authorization: Bearer $KROWS_SECRET_KEY"

# Next page: pass the id of the last item
curl "https://xvxhouuprjsmpfiwxkzz.supabase.co/functions/v1/api/v1/investments?limit=20&starting_after=inv_…" \
  -H "Authorization: Bearer $KROWS_SECRET_KEY"

{
  "object": "list",
  "data": [ { "object": "investment", "id": "inv_…", … } ],
  "has_more": true
}

Idempotencia

Al crear una sesión, manda Idempotency-Key. Si reintentas por un fallo de red, recibes la misma sesión en lugar de crear otra.

Errores

Códigos HTTP estándar y un cuerpo como este:

{
  "error": {
    "type": "invalid_request_error",
    "code": "amount_invalid",
    "message": "amount must be a USDC number, at least 1, with up to 2 decimals."
  }
}

Capítulo 5Registro y Workbench

En API y webhooks, la pestaña «Registro» muestra cada llamada a la API (método, ruta, código, tiempo, consulta, cuerpo y respuesta; nunca las cabeceras, donde va la clave) y cada entrega de webhook, con «Reenviar». Se guardan 30 días. El Workbench (tecla W o «Desarrolladores» en la barra inferior) junta eventos, registros y la salud de la integración; puedes ocultarlo en Ajustes › Desarrolladores, donde también eliges la versión de la API y el lenguaje de los ejemplos.

app.krows.app/ajustes/desarrolladores

Capítulo 6Repaso final

Antes de cerrar esta guía, comprueba que lo tienes claro. Nada de esto se envía a ningún sitio: es solo para ti.