API de emissão externa

Emita e revogue credenciais diretamente do seu sistema (ERP, plataforma de formação, CRM) sem passar pelo painel. Disponível nos planos Business e Enterprise — ver preços.

Autenticação

Gere uma chave em Definições → Integrações do seu painel (menu "Integrações" no dashboard). Envie-a no cabeçalho x-certify-key em cada pedido — não é preciso token JWT nestes endpoints. A organização é sempre resolvida a partir da chave, nunca de um parâmetro.

Limite: 60 pedidos por minuto por chave. Só organizações com verificationStatus: verified podem emitir — submeta a verificação em Definições antes de integrar.

Endpoints

POST/certificates

Emite uma credencial. credentialType aceita certificate, badge, credential, letter ou proof (por omissão: certificate).

curl -X POST "https://api.cloud.r360.ao/api/v1/certify/external/certificates" \
  -H "x-certify-key: cfy_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientName": "Maria João Silva",
    "recipientEmail": "maria@exemplo.com",
    "title": "Certificado de Conclusão",
    "programme": "Curso de Excel Avançado",
    "credentialType": "certificate"
  }'

POST/certificates/bulk

Emite várias credenciais numa só chamada. templateRef e issuanceMode aplicam-se a todo o lote.

curl -X POST "https://api.cloud.r360.ao/api/v1/certify/external/certificates/bulk" \
  -H "x-certify-key: cfy_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "recipientName": "Ana Costa", "title": "Certificado de Conclusão" },
      { "recipientName": "Pedro Neto", "title": "Certificado de Conclusão" }
    ]
  }'

PATCH/certificates/:ref/revoke

Revoga uma credencial. O ref é devolvido na resposta da emissão.

curl -X PATCH "https://api.cloud.r360.ao/api/v1/certify/external/certificates/<ref>/revoke" \
  -H "x-certify-key: cfy_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Emitido por engano" }'

Webhooks

Subscreva credential.issued e credential.revoked na mesma página de Integrações para ser notificado em tempo real, com assinatura HMAC-SHA256 no cabeçalho X-R360-Signature.

Já tem organização verificada? Gere a sua chave no painel.

Ir para Integrações