Maneja
Inicio / Desarrolladores y agentes

Maneja para desarrolladores y agentes

Documentación de la API pública y del MCP de Maneja: OpenAPI, ejemplos sin cuenta, autenticación y límites de acceso.

Utiliza la API pública de Maneja para identificar el producto, conocer sus capacidades y probar el formato de un horario ficticio. Estas consultas de lectura no necesitan cuenta ni clave. Esta API no permite consultar ni modificar los horarios de una empresa.

GET /api/public/product devuelve la identidad, el alcance y los enlaces del producto. GET /api/public/permissions describe las capacidades públicas y los límites de acceso empresarial. GET /api/public/examples/weekly devuelve una semana de ejemplo, con zona horaria explícita, turnos y descansos. El contrato OpenAPI 3.1 describe los tres endpoints con identificadores de operación únicos y esquemas de respuesta.

Para clientes MCP, conecta con https://maneja.eu/mcp mediante Streamable HTTP. Las herramientas get_product_info y get_sample_schedule son de lectura y no utilizan datos de clientes. Los recursos incluyen el contrato OpenAPI y las instrucciones para agentes. El transporte no mantiene estado ni sesiones MCP y permite respuestas JSON.

Los endpoints REST admiten 120 solicitudes por minuto por IP y endpoint; MCP admite 60. Una respuesta 429 indica que debes esperar el tiempo del encabezado Retry-After. MCP limita el cuerpo a 32 KiB. No envíes datos personales, secretos ni cookies de la aplicación a los endpoints públicos.

Las páginas públicas también admiten Accept: text/markdown. Las respuestas negociadas incluyen Vary: Accept, Accept-Encoding y no se almacenan en cachés compartidas. Consulta la documentación de acceso antes de proponer una integración con cuentas reales.

Probar la API

curl https://maneja.eu/api/public/product
curl https://maneja.eu/api/public/permissions
curl https://maneja.eu/api/public/examples/weekly
curl -H "Accept: text/markdown" https://maneja.eu/en/developers
Probar la API

[email protected]