Referencia de API

Referencia humana de la API on-demand para CRON PHP/IA.

Modelo del producto: nosotros ofrecemos API + worker. Cada hit a /track/{container} intenta una consulta nueva contra MSC; el consumidor decide frecuencia y guarda su propio histórico.

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

El Explorer está integrado en esta misma página. Cargá un token msc_..., completá parámetros, generá cURL y ejecutá requests reales. Ejecutar /track lanza el worker en vivo.

Ver OpenAPI JSON

Auth

Panel/web: cookie de sesión creada con POST /api/login.
Cron/API externa: X-Api-Key: msc_....
Scopes: track para /track/{container}; context para /llm/context.
Para IA/agente, usar token con track,context.
La API externa usa exclusivamente tokens msc_... en X-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 on-demand para CRON PHP/IA. Cada llamada dispara worker y devuelve JSON + screenshot base64 opcional. El cliente guarda lo que necesite.
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*`	login web	Panel interno/admin para pruebas y último resultado visible. No es contrato externo.
GET	`/api/worker/*`	login web	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/MEDU9730548

Endpoint para IA / agente

Si querés darle la API a una IA, pasale un token con scope track,context y este endpoint: