Por qué documentamos toda la API
Una forma rápida de evaluar un producto es mirar su API. Si existe, está documentada y deja hacer lo mismo que la interfaz, podés automatizar, integrar y, si hace falta, irte. Si son tres endpoints escondidos y un "contactá a ventas", no.
Link nació con su API pública. Hoy la API v1 cubre también CRM, Cal y Agents.
Qué cubre la API v1
Cada endpoint está documentado en /docs, con ejemplos en curl, JavaScript, Python y Go, y hay una spec OpenAPI 3.1 para descargar.
- Link: crear (
POST /api/v1/links, con slug, tags y UTM), listar, actualizar, borrar y leer estadísticas (GET /api/v1/links/:id/stats). - CRM: contactos, empresas, deals, actividades, tareas, pipelines, productos, cotizaciones, asociaciones, tags, secuencias y formularios.
- Cal: tipos de evento y reservas (listar, crear, ver, cancelar).
- Agents: mandarle un mensaje a un agente desde tu app.
La autenticación es una clave personal en Authorization: Bearer, con scopes que elegís al crearla (por ejemplo links:read o crm:write). Cada clave admite 100 requests por minuto; si te pasás, la respuesta es un 429 con Retry-After. Los errores vuelven en JSON con códigos estables.
curl -X POST https://zerosoft.ai/api/v1/links \
-H "Authorization: Bearer zs_..." \
-H "Content-Type: application/json" \
-d '{"url": "https://tuempresa.com/launch", "slug": "launch"}'
Webhooks
Para enterarte de lo que pasa sin preguntar: link.created, link.clicked, booking.*, y eventos de contactos y deals del CRM, firmados con HMAC-SHA256 y con reintentos. El detalle está en webhooks: firmar y verificar.
Por qué importa
- Podés automatizar tu salida. Un script corto recorre tus links, baja las estadísticas y los recrea en otro lado, sin nuestra ayuda.
- Podés integrarte sin pedir permiso. Si tu sistema habla HTTP, habla con zerosoft.
- El plan B ya existe. El código es abierto. Si mañana dejamos de existir, tu script apunta a tu propio servidor con la misma API.
Lo que falta: Track, Docs, Chat, Flow, Robots, Notes y Board todavía no tienen endpoints públicos.