---
title: "API pública da Conforpés — documentação"
url: "https://www.conforpes.com.br/docs"
language: "pt-BR"
---

# 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.

- Especificação OpenAPI 3.1: https://www.conforpes.com.br/openapi.json
- URL base: `https://www.conforpes.com.br/wp-json`
- Catálogo de APIs (RFC 9727): https://www.conforpes.com.br/.well-known/api-catalog
- Orientações para agentes: https://www.conforpes.com.br/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 https://www.conforpes.com.br/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.params` explica 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.

## Contato

Conforpés — https://www.conforpes.com.br/contato/ · [Sobre](https://www.conforpes.com.br/sobre/) · [Privacidade](https://www.conforpes.com.br/privacidade/)