Referencia de API
Referencia humana de endpoints, auth y ejemplos para CRON PHP/IA.
Todo está detrás de login salvo /login, /api/login y /track/{container}, que es público pero requiere API token.
Probar esta API ahora
Abajo tenés el API Explorer integrado. También podés abrirlo en pantalla completa o consultar el OpenAPI JSON.
Auth
- Panel/web: cookie de sesión creada con
POST /api/login. - Cron/API externa:
X-Api-Key: msc_.... - Scopes:
trackpara/track/{container};contextpara/llm/context. - Para IA/agente, usar token con
track,context. - La API externa usa exclusivamente tokens
msc_...enX-Api-Key.
Endpoints
| Method | Path | Acceso | Uso |
|---|---|---|---|
| GET | /login | público | Form web. |
| POST | /api/login | público | Login web. Body {username,password}. |
| POST | /api/logout | login | Cerrar sesión. |
| GET | /api/me | login | Usuario actual. |
| POST | /api/me/password | login | Cambiar password propia. |
| GET | /track/{container} | API token scope track | Endpoint recomendado para CRON PHP/IA. Devuelve JSON + screenshot base64. |
| GET | /llm/context | API token scope context | Contexto machine-readable para que una IA entienda cómo usar la API. |
| GET | /docs, /docs/* | login | Documentación privada. |
| GET/POST/PATCH/DELETE | /api/containers* | Tailscale + login | Lista persistente y scheduler. |
| GET | /api/worker/* | Tailscale + login | Status/logs del worker. |
| GET/POST/DELETE | /api/admin/* | Tailscale + admin | Users y API tokens. |
Ejemplo cron
curl -s -H "X-Api-Key: msc_TU_TOKEN" \
https://msc-vercel-supabase.vercel.app/msc-api/track/MEDU9730548Endpoint para IA / agente
Si querés darle la API a una IA, pasale un token con scope track,context y este endpoint:
curl -s -H "X-Api-Key: msc_TU_TOKEN" \
https://msc-vercel-supabase.vercel.app/msc-api/llm/context