Eel

Tu primera petición

De cero a una respuesta, con curl.

Cuatro pasos para pasar de no tener nada a leer y escribir datos reales de tu espacio de trabajo desde la terminal.

1. Consigue una clave

En Nest, Espacio de trabajo → Claves de API → Crear clave. Marca los permisos que vayas a usar y guarda el token: lo ves una sola vez.

Solo los propietarios y administradores del espacio pueden crear claves. Ver Claves de API.

2. Comprueba que funciona

La lectura más barata de toda la suite es el espacio al que pertenece la clave. Necesita el permiso nest:workspace:read:

curl -s https://nest.eel.software/api/public/v1/workspace \
  -H "Authorization: Bearer eel_sk_..."
{ "id": "…", "name": "Acme", "created_at": "2026-01-14T15:22:03.000Z" }

Si eso responde, la credencial está bien y el resto es cuestión de permisos.

3. Lee algo real

Los primeros veinticinco contactos, con wrap:contacts:read:

curl -s "https://wrap.eel.software/api/public/v1/contacts?limit=25" \
  -H "Authorization: Bearer eel_sk_..."

4. Escribe algo

Los POST que crean algo exigen la cabecera Idempotency-Key. Genera una clave por operación:

curl -s -X POST https://wrap.eel.software/api/public/v1/contacts \
  -H "Authorization: Bearer eel_sk_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name":"Ana Restrepo","email":"ana@ejemplo.com"}'

Repite el mismo comando sin cambiar la clave de idempotencia y vas a recibir la misma respuesta, no un segundo contacto. Cambia el cuerpo dejando la clave y recibes un 409.

Si algo falla

Lo que ves Casi siempre es
401 con credencial válida bearer en minúscula, o un espacio de más
403 Falta el permiso. El mensaje dice cuál
400 pidiendo Idempotency-Key Un POST sin esa cabecera
404 en algo que sabes que existe Está en otro espacio, o la credencial no lo ve
429 Pasaste el ritmo. Espera lo que diga Retry-After

Sigue por aquí