# 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.

Canonical: https://maneja.eu/developers

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.

```sh
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
```

## Recursos da Maneja

- [Como funciona](https://maneja.eu/how-it-works)
- [Regras e lei laboral](https://maneja.eu/labour-law)
- [Para a tua empresa](https://maneja.eu/for-companies)
- [Sobre a Maneja](https://maneja.eu/about)
- [Contacto](https://maneja.eu/contact)
- [Privacidade](https://maneja.eu/privacy)
- [Developers e agentes](https://maneja.eu/developers)
- [Acesso e permissões](https://maneja.eu/developers/auth)
- [Exemplos públicos](https://maneja.eu/developers/sandbox)
- [Guia de horários](https://maneja.eu/guides/retail-scheduling)
- [OpenAPI](https://maneja.eu/openapi.json)
- [MCP](https://maneja.eu/mcp)
- [Email](mailto:manejaeu@gmail.com)