API pública da Conforpés
API somente leitura com o conteúdo público do site da Conforpés, clínica de próteses ortopédicas desde 1968, com unidades em Sorocaba e São Paulo (Ipiranga). É a REST API do WordPress do site, documentada em OpenAPI.
- URL base:
https://www.conforpes.com.br/wp-json - Catálogo de APIs (RFC 9727): /.well-known/api-catalog
- Orientações para agentes: llms.txt
Quando usar
Use esta API para consultar o que a Conforpés publica: artigos sobre próteses, amputação, reabilitação, direitos e esportes adaptados; páginas institucionais (Sobre, Contato, Privacidade, Termos); e materiais educativos. Ela não agenda consultas, não envia mensagens e não tem dados de pacientes. Para avaliação gratuita ou atendimento, encaminhe a pessoa para a página de contato.
Autenticação
Nenhuma. Todas as operações documentadas são GET públicas.
Operações
| operationId | Método e caminho | Para que serve |
|---|---|---|
listPosts | GET /wp/v2/posts | Lista artigos (filtros search, categories, slug) |
getPost | GET /wp/v2/posts/{id} | Artigo completo pelo ID |
listPages | GET /wp/v2/pages | Páginas institucionais (slug=sobre, contato, privacidade) |
getPage | GET /wp/v2/pages/{id} | Página pelo ID |
listMaterials | GET /wp/v2/material | Materiais educativos |
listCategories | GET /wp/v2/categories | Categorias do blog com quantidade de artigos |
searchContent | GET /wp/v2/search | Busca textual em todo o conteúdo |
Paginação: per_page (1 a 100, padrão 10) e page. O total vem nos cabeçalhos X-WP-Total e X-WP-TotalPages. Use _fields para devolver só os campos necessários.
Exemplos
Buscar artigos sobre próteses biônicas:
curl 'https://www.conforpes.com.br/wp-json/wp/v2/posts?search=bionica&per_page=5&_fields=id,title,link,excerpt'
Ler a página de contato (endereços, telefones e horários):
curl 'https://www.conforpes.com.br/wp-json/wp/v2/pages?slug=contato&_fields=title,link,content'
Listar as categorias do blog:
curl 'https://www.conforpes.com.br/wp-json/wp/v2/categories?hide_empty=true&_fields=id,name,count,link'
Erros
Os erros são JSON no formato {"code": "...", "message": "...", "data": {"status": 404}}. Exemplos:
rest_post_invalid_id(404): o ID não existe.rest_invalid_param(400): parâmetro inválido;data.paramsexplica qual e por quê.rest_no_route(404): o caminho não existe na API.
Caminhos inexistentes em /api/... também devolvem 404 em JSON, com links para esta documentação.
Limites e boas práticas
Não há limite de requisições publicado. Faça requisições em sequência, use _fields e guarde os resultados em cache: o conteúdo muda poucas vezes por semana.