Documentação

Guia de início rápido

A API pública do CertMe é REST, versionada (/v1) e autenticada via OAuth2 client_credentials. Você troca uma credencial de longa duração por um access token JWT de curta duração (~15 min) e consome os endpoints da sua organização.

1. Crie uma credencial

No portal, acesse API → Credenciais → Nova credencial. Escolha os escopos de menor privilégio (ex.: trainings:read, certificates:write). O client_secret é exibido uma única vez — copie-o com segurança.

2. Obtenha um access token

curl -X POST https://api.certme.pro/v1/oauth/token \
  -d grant_type=client_credentials \
  -d client_id=cmci_xxx \
  -d client_secret=cmcs_xxx \
  -d 'scope=trainings:read'

Resposta:

{ "access_token": "...", "token_type": "Bearer", "expires_in": 900, "scope": "trainings:read" }

3. Chame um endpoint

curl https://api.certme.pro/v1/trainings \
  -H "Authorization: Bearer $ACCESS_TOKEN"

4. Operações de escrita (idempotentes)

Operações de escrita aceitam o cabeçalho Idempotency-Key (recomendado): reenvios com a mesma chave não duplicam o efeito por 24h.

curl -X POST https://api.certme.pro/v1/certificates \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ "trainingId": "...", "userId": "..." }'

Dados pessoais de participantes (nomes) só aparecem quando a credencial tem o escopo attendees:pii.

Ver a referência completa da API (v1) →