Maneja para developers e agentes
Documentação da API pública e do MCP da Maneja: OpenAPI, exemplos sem conta, autenticação e limites de acesso.
Usa a API pública da Maneja para identificar o produto, verificar as capacidades disponíveis e experimentar o formato de um horário fictício. Não precisas de conta nem de chave para estes pedidos de leitura. Não é uma API para consultar ou alterar os horários de uma empresa.
GET /api/public/product devolve a identidade, o âmbito e os links do produto. GET /api/public/permissions descreve as capacidades públicas e os limites do acesso empresarial. GET /api/public/examples/weekly devolve uma semana de exemplo, com timezone explícita, turnos e pausas. O contrato OpenAPI 3.1 descreve os três endpoints com operationId único e schemas de resposta.
Para clientes MCP, liga a https://maneja.eu/mcp através de Streamable HTTP. As ferramentas get_product_info e get_sample_schedule são de leitura e não usam dados de clientes. Os recursos incluem o contrato OpenAPI e as instruções para agentes. O transporte é sem estado, aceita respostas JSON e não mantém sessões MCP.
Os endpoints REST têm um limite de 120 pedidos por minuto por IP e por endpoint; o MCP permite 60. Uma resposta 429 indica que deves aguardar o tempo do cabeçalho Retry-After. O MCP limita o corpo a 32 KiB. Não envies dados pessoais, segredos ou cookies da aplicação aos endpoints públicos.
As páginas públicas também suportam Accept: text/markdown. As respostas negociadas incluem Vary: Accept, Accept-Encoding e não são guardadas em cache partilhada. Consulta a documentação de acesso antes de propor uma integração com contas reais.
Experimentar a 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