API de Skillion

Tu primera llamada#

1. 1

   Saca tu clave en la app: Ajustes → toca 7 veces la versión → API para desarrolladores. Paso a paso, con todo detalle

   Ojo

   Necesitas Skillion Premium y una cuenta registrada (no de invitado). Sin Premium la fila sale con candado y abre la pantalla de suscripción.

2. 2

   Pide tu perfil:

   curlCopiar

   export SKILLION_KEY="sk_live_…"   # la tuya, de la app
   
   curl https://api.skillion.app/functions/v1/api/v1/me \
     -H "Authorization: Bearer $SKILLION_KEY"

3. 3

   Te devuelve tu nivel, XP, monedas y energía, y tus límites:

   Respuesta · ejemplo

   {
     "data": {
       "level": 7,
       "total_xp": 140,
       "xp_to_next_level": 350,
       "coins": 820,
       "energy_points": 64,
       "max_energy": 100,
       "health_points": 100,
       "max_health": 100,
       "nickname": "Luna",
       "updated_at": "2026-10-21T18:00:00Z"
     },
     "limits": { "per_minute": 120, "per_day": 10000, "page_max": 100 }
   }

Tu clave#

1. 1

   Abre Skillion y ve a Ajustes.

2. 2

   Baja hasta el final y toca siete veces seguidas la línea «Versión …», con menos de 2 segundos entre toque y toque. El móvil vibra y sale «Opciones de desarrollador activadas».

3. 3

   En Ajustes aparece una fila nueva: «API para desarrolladores». Ábrela.

4. 4

   Toca «Crear clave», ponle un nombre y toca «Crear». Después toca «Copiar»: la clave solo se enseña una vez. Puedes tener hasta 5 activas y revocar cualquiera desde esa pantalla.

Autenticación#

Manda la clave como token Bearer en cada petición. Todos los cuerpos van en JSON.

curl https://api.skillion.app/functions/v1/api/v1/me \
  -H "Authorization: Bearer sk_live_…"

Completar una tarea no es inmediato#

Las tareas de un pacto se completan con un check-in en la app y los malos hábitos nunca se completan: las dos dan 409.

Endpoints#

Listas y paginado#

Las listas vienen del cambio más antiguo al más nuevo. Devuelve next_cursor como cursor hasta que sea null. Lo borrado y lo archivado no sale salvo que lo pidas.

Campos de tarea que puedes poner#

Solo title es obligatorio. Lo demás (XP, nivel, estado, monedas ganadas) lo calcula la app y es de solo lectura. Un campo desconocido da 422, así que una errata nunca pasa desapercibida.

Campos de skill que puedes poner#

level, total_xp (el XP dentro del nivel actual) y las rachas son de solo lectura. Las cuentas gratis mantienen 3 skills activas, pero la API en sí es solo Premium.

Rutinas y sus bloques#

Una rutina es un día de la pantalla de time blocking («Lunes», «Día de trabajo»…) con sus bloques dentro. Una semana entera son siete POST /v1/routines, uno por día.

Rutina

Cada bloque de blocks

blocks es siempre la lista entera: un bloque con id se actualiza, uno sin id se crea y el que no mandes se borra. Si no mandas blocks en un PATCH, se quedan como están. Los bloques vuelven con start_time y end_time («07:30») para leerlos fácil.

Errores#

Los errores tienen siempre la misma forma. details dice qué campo no es válido.

{
  "error": {
    "code": "invalid_field",
    "message": "Some fields are not valid.",
    "details": { "custom_days": "must be weekdays like \"1,3,5\" …" }
  }
}

Límites#

120 peticiones por minuto

por cuenta, todas tus claves juntas

10.000 peticiones al día

por cuenta, el día empieza a las 00:00 UTC

100 elementos por página

50 por defecto

64 KB por cuerpo

Si te pasas recibes 429 con la cabecera retry-after (segundos). Cada respuesta lleva x-ratelimit-limit y x-ratelimit-remaining.

Borrar#

DELETE hace lo mismo que la app: las skills y las tareas recurrentes se archivan (su historial se queda) y las tareas sueltas se borran, y una rutina se borra con sus bloques. En todos los casos desaparecen de tu móvil en el siguiente sync.

Conviene saber#

• Los cambios llegan a tu móvil en el siguiente sync, normalmente al abrir la app.
• Si editas la misma tarea en el móvil antes de que sincronice, gana el móvil.
• Las tareas recurrentes reciben su próxima fecha desde tu móvil, que sabe tu zona horaria y tu hora de reinicio.
• Las fechas van en ISO 8601 con zona horaria, por ejemplo 2026-10-21T18:00:00Z.

Ejemplos#

Crear una tarea recurrente unida a una skill

curl -X POST https://api.skillion.app/functions/v1/api/v1/tasks \
  -H "Authorization: Bearer $SKILLION_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Gym",
    "is_recurring": true,
    "recurrence_pattern": "custom",
    "custom_days": "1,3,5",
    "difficulty": "hard",
    "skills": [{ "skill_id": "<skill id>", "xp": 20 }]
  }'

Completarla (desde un atajo, un cron, un botón)

curl -X POST https://api.skillion.app/functions/v1/api/v1/tasks/<task id>/complete \
  -H "Authorization: Bearer $SKILLION_KEY"

# 202 → { "data": { "id": "…", "status": "pending", … } }

Leer todo lo que cambió desde ayer

const since = new Date(Date.now() - 86_400_000).toISOString()
let cursor = null
do {
  const url = new URL('https://api.skillion.app/functions/v1/api/v1/tasks')
  url.searchParams.set('updated_since', since)
  if (cursor) url.searchParams.set('cursor', cursor)
  const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.SKILLION_KEY}` } })
  const page = await res.json()
  for (const task of page.data) console.log(task.title, task.status)
  cursor = page.next_cursor
} while (cursor)

Organizar la semana: una rutina por día

const days = ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday']
for (const name of days) {
  const weekend = name === 'Saturday' || name === 'Sunday'
  const res = await fetch('https://api.skillion.app/functions/v1/api/v1/routines', {
    method: 'POST',
    headers: { Authorization: `Bearer ${process.env.SKILLION_KEY}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({
      name,
      blocks: [
        { start_minute: weekend ? 540 : 420, duration_minute: 30, title: 'Read' },
        { start_minute: 1080, duration_minute: 60, title: 'Gym', color: '#F29092' },
        { start_minute: 1380, duration_minute: 60, title: 'Wind down' },
      ],
    }),
  })
  if (!res.ok) console.error(name, (await res.json()).error)
}