Ir al contenido

Autenticación

La API REST de Todomino vive en https://app.todomino.eu/api y usa tokens de acceso personales (PAT) para el acceso programático — integraciones, scripts y automatizaciones.

  1. Abre Ajustes → General → Tokens de API en Todomino.
  2. Nombra el token según la integración a la que va destinado (por ejemplo home-automation), para poder revocarlo de forma independiente.
  3. Copia el token inmediatamente — empieza por tdm_ y se muestra una sola vez.

Envía el token como bearer token en cada petición:

Terminal window
curl -H "Authorization: Bearer tdm_..." \
https://app.todomino.eu/api/workspaces

Los tokens tienen los mismos permisos que tu cuenta: cada espacio de trabajo del que eres miembro, con tu rol en cada uno.

  • Revocación: elimina un token en los ajustes en cualquier momento; deja de funcionar de inmediato.
  • Un token por integración: así una filtración o revocación nunca afecta a todo lo demás.
  • Respuestas de error habituales: 401 (token ausente o inválido), 403 (cuenta válida pero rol insuficiente), 404 (también para espacios de los que no eres miembro), 409 (conflicto, p. ej. edición simultánea), 413 (límite de almacenamiento del espacio alcanzado).