API pública do Sostenere

Dados oficiais do Sostenere, o app gratuito de cuidado para pessoas idosas e suas famílias, em JSON. Base: https://sostenere.com.br/api/v1.

Acesso e autenticação

• Somente leitura e pública: não precisa de chave, cadastro nem aprovação. Gratuita, sem plano pago e sem formulário de contato comercial.
• Não há ambiente de teste separado: o ambiente público é o mesmo e não altera nada, então é seguro chamar à vontade.
• Escopo único: site:read, concedido a qualquer cliente. Veja /.well-known/oauth-protected-resource.
• Não existe API de contas, de medicamentos ou de localização: dados das pessoas acompanhadas nunca são expostos aqui.

Endpoints

• GET /api/v1 — índice com os links dos endpoints.
• GET /api/v1/site — resumo do produto: nome, descrição, preço, disponibilidade.
• GET /api/v1/features — os cinco recursos do app.
• GET /api/v1/faq — perguntas frequentes com respostas.
• GET /api/v1/pages — páginas públicas do site.
• GET /api/v1/contact — canal de atendimento.
• GET /api/v1/search?q=medicamentos&limit=5 — busca em recursos, perguntas e páginas.

Exemplos

curl -sS https://sostenere.com.br/api/v1/site
curl -sS "https://sostenere.com.br/api/v1/search?q=emergencia&limit=3"
curl -sS https://sostenere.com.br/api/v1/nao-existe

Erros

Todo erro sob /api vem em JSON, com o mesmo formato:

{"error":{"status":404,"code":"not_found","message":"...","hint":"...","documentation_url":"https://sostenere.com.br/api"}}

• 400 missing_parameter / invalid_parameter — falta q ou limit fora de 1 a 20.
• 404 not_found — endpoint inexistente.
• 405 method_not_allowed — só GET, HEAD e OPTIONS.

Para agentes

• OpenAPI 3.1
• Servidor MCP (Streamable HTTP, sem autenticação) e manifesto
• llms.txt — quando usar o Sostenere e como chamar
• Catálogo de APIs e mapa do site

Dúvidas: suporte@sostenere.com.br.