Saltar al contenido principal

REST API

La API REST de TodoMate te permite gestionar tus tareas, objetivos y visión desde cualquier cliente HTTP. Esta guía te explica cómo obtener un token y hacer tu primera solicitud con curl.

Requisitos previos​

  • Una cuenta en todo.ac (inicia sesión con GitHub)
  • Una suscripción Pro — necesaria para generar una clave API

Paso 1 — Instala el CLI de GitHub​

La forma más sencilla de obtener un token de acceso de GitHub es con el CLI de GitHub.

# macOS
brew install gh

# Windows
winget install GitHub.cli

# Linux — consulta https://github.com/cli/cli/blob/trunk/docs/install_linux.md

Paso 2 — Obtén un token de acceso de GitHub​

gh auth login
gh auth token

Copia el token que se muestra — lo usarás en el Paso 4.

Paso 3 — Obtén tu clave API​

Tu clave API autentica tu cliente con la API.

  1. Abre todo.ac
  2. Ve a Cuenta → Claves API
  3. Pulsa Generar clave, asígnale un nombre y copia el valor — solo se muestra una vez

Paso 4 — Obtén un JWT de TodoMate​

Intercambia tu token de GitHub por un JWT de corta duración:

JWT=$(curl -s -X POST https://api.todo.ac/v1/auth/token \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: TU_CLAVE_API" \
  -d '{"github_token": "TU_TOKEN_DE_GITHUB"}' \
  | jq -r '.access_token')

echo $JWT

Nota: jq se usa aquí para analizar la respuesta JSON. Instálalo con brew install jq o tu gestor de paquetes.

Paso 5 — Lista tus tareas​

curl https://api.todo.ac/v1/todos \
  -H "Authorization: Bearer $JWT" \
  -H "Ocp-Apim-Subscription-Key: TU_CLAVE_API"

Deberías recibir un array JSON con tus tareas.

Siguientes pasos​

Explora la Referencia de API completa para ver todos los endpoints disponibles — tareas, objetivos, visión y más.