Informação legal
Celebria para programadores
Como agentes e programadores devem usar o marketplace de eventos Celebria: páginas públicas, llms.txt, OpenAPI e a pesquisa.
Última atualização:
Quando usar a Celebria
Use a Celebria para encontrar um espaço ou um serviço de eventos em Portugal e devolver o URL canónico do anúncio. Serve para festas, casamentos, eventos corporativos e celebrações privadas.
Não use a API para confirmar uma reserva, inventar um preço ou pesquisar venues fora de Portugal. Essas confirmações estão na página HTML do anúncio.
Leitura pública
O catálogo em HTML (/spaces, /servicos, /diretorio), o mapa /llms.txt e esta documentação são públicos e não precisam de sessão. A especificação está em /openapi.json. O alias em inglês da marca é /about; o contacto é /contact e a privacidade é /privacy.
Pesquisa
POST /api/search com o corpo JSON {"query":"o que a pessoa precisa"}. Sem sessão, o limite é 3 pedidos em 24 horas. Com sessão iniciada, o limite é 10. Cada resposta traz RateLimit-Policy e RateLimit. Um HTTP 429 traz também Retry-After, em segundos.
Escrita e suporte
Criar anúncios, mensagens, pagamentos e o painel exigem uma sessão de utilizador. Esses endpoints não fazem parte do contrato público em /openapi.json. Dúvidas de integração: suporte@celebriaeventos.pt.