API de integração — v1

APIs consultivas para o site, sistema de aplicação de provas e ERP (SAP). Autenticação por Authorization: Bearer <token>; tokens são gerados em Admin → Integrações.

GET/api/v1/public/cursos

Lista cursos com inscrições abertas (sem autenticação). Usado pela página de cursos do site.

GET/api/v1/associados?cpf=&crm=&status=&regional=

Lista associados com filtros.

GET/api/v1/associados/{id}

Dados completos do associado (CRMs, especialidades, títulos).

GET/api/v1/associados/{id}/situacao

Situação resumida: associado ativo? adimplente? — ideal para o sistema de provas.

GET/api/v1/cursos · /api/v1/cursos/{id}

Cursos e eventos.

GET/api/v1/faturas?status=paid&paid_from=2026-01-01&kind=anuidade

Faturas e pagamentos para conciliação no ERP.

Exemplo

curl -H "Authorization: Bearer SEU_TOKEN" -H "Accept: application/json" \
  https://sbp.agencianewton.com/api/v1/associados/1/situacao

{ "matricula": "SBP000001", "nome": "Dra. …", "associado": true, "categoria": "Titular", "adimplente": true, "ano_referencia": 2026 }

Integrações de escrita (ex.: provas enviando resultados) e webhooks de pagamento serão definidos no projeto.