Para agentes de IA: pedir orçamento por API ou MCP

Agentes de IA pedem orçamento por POST /api/orcamento ou pela ferramenta MCP pedir_orcamento em /mcp. São obrigatórios 6 campos, incluindo email, concelho e tipo de cobertura; a área em m² é opcional; erros devolvem HTTP 422 por campo. Com X-Dry-Run: 1 o pedido só é validado, sem ser registado.

Atualizado em · fontes indicadas em cada tabela

Assistentes de IA podem pedir um orçamento de remoção de amianto em nome de um utilizador, depois de ele autorizar o tratamento dos dados. O pedido entra no mesmo fluxo do formulário e respondemos por email.

Endpoints

Endpoints para agentes
EndpointMétodoUso
/api/orcamentoPOST JSONPedido de orçamento; validação com erros 422 por campo
/api/orcamentoGETDescrição dos campos
/mcpPOST (MCP Streamable HTTP)Ferramentas pedir_orcamento, consultar_precos, zonas_servidas
/mcp/server-cardGETCartão do servidor MCP
/openapi.jsonGETDescrição OpenAPI 3.1
/llms.txt e /llms-full.txtGETResumo e texto integral do site

Documentação técnica deste site · Atualizado em 23 de outubro de 2026.

Campos do pedido

Obrigatórios: nome, email, concelho (um dos 17 da AMP), tipo_cobertura, servico e consent (true, só depois de o utilizador autorizar). Opcionais: area_m2 (número de 1 a 20000), telefone, estado, descricao, agente, dry_run.

curl -X POST https://amiantoporto.pt/api/orcamento -H "Content-Type: application/json" -H "X-Dry-Run: 1" -d '{"nome": "Ana Silva", "email": "ana@example.pt", "concelho": "Matosinhos", "tipo_cobertura": "Telhado de anexo, garagem ou alpendre", "area_m2": 35, "servico": "Remover amianto", "consent": true}'

Com X-Dry-Run: 1 ou "dry_run": true o pedido só é validado. Erros de validação devolvem HTTP 422 com a lista de campos e mensagens. Há limite de pedidos por endereço e por dia.

Regras para agentes