Desenvolvedores

API e dados abertos da Associação VEM

Os dados públicos do site — cursos, blog e relatórios de transparência — em formatos que pessoas, programas e agentes de IA conseguem ler.

Por onde começar

Especificação OpenAPI 3.1: /openapi.json
Base da API REST: https://www.associacaovem.org.br/api — somente leitura nas rotas públicas, sem autenticação, respostas em JSON e listas paginadas.
Mapa do site para agentes: /llms.txt · Sitemap: /sitemap.xml
Qualquer página responde em Markdown quando a requisição envia Accept: text/markdown.

Rotas públicas

Método	Rota	O que retorna
GET	/api/projetos	Cursos e projetos, com dias, horários, taxa de inscrição e contribuição mensal
GET	/api/projetos/{id}	Um curso ou projeto
GET	/api/posts	Publicações do blog (somente as publicadas)
GET	/api/posts/{id}	Uma publicação
GET	/api/relatorios	Relatórios mensais e anuais: título, mês de referência, descrição e link do PDF
GET	/api/relatorios/file/{filename}	O PDF de um relatório
GET	/api/globals/configuracoes	E-mail, telefone, WhatsApp, endereço e redes sociais

Filtros usam a sintaxe where[campo][operador]=valor do Payload CMS — por exemplo, where[slug][equals]=arteterapia para achar um projeto pelo endereço da página.

Exemplos

curl 'https://www.associacaovem.org.br/api/projetos?limit=50&depth=0&sort=order'
curl 'https://www.associacaovem.org.br/api/relatorios?where[reportType][equals]=anual&sort=-referenceDate'
curl -H 'Accept: text/markdown' 'https://www.associacaovem.org.br/'

Boas práticas

Não há limite de requisições publicado. Faça cache das respostas — o conteúdo muda poucas vezes por semana — e evite rajadas.
Inscrições, doações e mensagens são feitas pelas páginas do site; essas ações não fazem parte da API pública.
Dúvidas técnicas: contato@associacaovem.org.br.