Skip to main content

Quick Start

Este guia mostra como emitir um certificado digital de ponta a ponta utilizando chamadas reais à API. O utilizador vai criar as entidades mínimas necessárias e emitir um certificado numa única sessão.
Todas as entidades devem pertencer ao mesmo tenant. Obtenha as suas credenciais de integração junto ao seu gestor de conta DokStamp antes de começar.

Pré-requisitos

  • Credenciais de integração (client_id e client_secret) — fornecidas pelo seu gestor de conta DokStamp
  • O seu identificador X-Tenant
  • Um ficheiro PDF do certificado a ser emitido

Passo 1 — Obter um Token de Serviço

Guarde o access_token da resposta. É válido por 12 horas. Utilize-o em todos os pedidos subsequentes.

Passo 2 — Criar uma Instituição

Uma instituição é o órgão emissor. Deve existir antes de cursos ou certificados.
Guarde o uuid da resposta — será necessário como institution_uuid.

Passo 3 — Criar um Curso

Guarde o uuid como course_uuid.

Passo 4 — Criar um Estudante

Guarde o uuid como student_uuid.

Passo 5 — Carregar o PDF

Carregue o ficheiro PDF do certificado assinado:
A resposta devolve um array. Guarde o uuid do primeiro item como file_uuid.

Passo 6 — Emitir o Certificado

Agora combine tudo num certificado:
Resposta:
O public_verification_url é o link partilhável para verificação da credencial.

O que fazer a seguir?

Ordem de Registo de Entidades

Veja o mapa completo de dependências antes de construir integrações.

Ciclo de Vida do Certificado

Saiba como os certificados passam de rascunho a emitido, revogado e expirado.

Guia: Emitir Certificado

Um guia mais detalhado com módulos, turmas, matrículas e templates.

Referência da API

Referência completa de parâmetros para cada endpoint.