EMPEZAR

Primera llamada a la API

Crea tu primera nota vía la API REST.

Todas las respuestas siguen el mismo sobre uniforme: {"ok": true, "data": ...} en éxito, {"ok": false, "error": "..."} en fallo — incluidos los errores HTTP estándar (404, 405...), que nunca devuelven HTML.

1. 1

   Consigue un token

   Sigue la página de Autenticación para registrarte o iniciar sesión.

2. 2

   Crea un menú (categoría)

   Las notas y tareas viven dentro de un menú — necesitas uno antes de crear nada.

3. 3

   Crea la nota

   Con el id del menú, ya puedes anotar algo.

TOKEN="kf83h2n..."

# 1. Crea un menú
curl -X POST https://tu-hostname/api/v1/categorias \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"nombre": "Cliente Alfa"}'
# -> {"ok":true,"data":{"id":7,"nombre":"Cliente Alfa", ...}}

# 2. Crea la nota en ese menú
curl -X POST https://tu-hostname/api/v1/notas \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"texto": "Primera nota desde la API", "categoria_id": 7}'
# -> {"ok":true,"data":{"id":123,"texto":"Primera nota desde la API",
#      "creada_en":"2026-08-01T10:15:03", "categoria_id":7, ...}}

La nota queda con fecha y hora exactas de creación (creada_en, ISO 8601, hora local del servidor) — el mismo campo que usa el resto de la app para el registro cronológico.

Siguiente paso