niiko/developers

Empezar

Inicio rápido

Tres pasos: crear una llave, encender la acción, llamar.

Última actualización

1 · Crea una llave de API

En tu workspace: Configuración → Desarrolladores → Llaves. Elige los alcances de las acciones que la integración va a ejercer. La llave se muestra una sola vez, al crearla — empieza por nk_.

2 · Enciende la acción

Configuración → Conexiones, columna «API y MCP». Cada acción tiene su propio interruptor, apagado por defecto. Tener la llave no basta: la llave y el interruptor son dos decisiones de personas distintas.

Dos permisos, no uno

Además de la credencial, cada acción y cada lectura necesitan que el dueño del workspace las haya encendido (Configuración → Conexiones, columna «API y MCP»). El motivo es deliberado: quien tiene una llave y quien es dueño del workspace suelen ser dos personas distintas, y cada una decide.

3 · Llama

Cada ejemplo de este sitio se genera del mismo contrato que el servidor aplica. Elige tu cliente:

# One request, one idempotency key: retrying with the same key never runs twice.
curl -X POST https://niiko.org/api/v1/actions/miira.lead_create \
  -H "Authorization: Bearer nk_…" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "submissionId": "01890a5d-ac96-774b-bcce-b302099a8057",
    "source": "web_form"
  }'
# 200 → done · 202 → pending_approval (a person signs later) · 4xx → refused, with a named reason

Qué leer después

  • Tres desenlaces — Hecho, negado con un motivo con nombre, o esperando una firma.
  • Idempotencia — Con una Idempotency-Key nada corre dos veces.
  • Webhooks — Registra un destino y niiko te avisa cuando algo se resuelve — sobre todo lo que quedó en pending_approval, que por definición termina después de que colgaste.
  • Todas las acciones
  • Todas las lecturas — llevan un token OAuth en vez de una llave, concedido por una persona.