Skip to main content

Quick Start

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

Pré-requisitos

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

Passo 1 — Obter um Token de Serviço

Salve o access_token da resposta. Ele é válido por 12 horas. Use-o em todas as requisições subsequentes.

Passo 2 — Criar uma Instituição

Uma instituição é o órgão emissor. Ela deve existir antes de cursos ou certificados.
Salve o uuid da resposta — você vai precisar dele como institution_uuid.

Passo 3 — Criar um Curso

Salve o uuid como course_uuid.

Passo 4 — Criar um Estudante

Salve o uuid como student_uuid.

Passo 5 — Fazer Upload do PDF

Faça o upload do arquivo PDF do certificado assinado:
A resposta retorna um array. Salve o uuid do primeiro item como file_uuid.

Passo 6 — Emitir o Certificado

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

O que fazer a seguir?

Ordem de Cadastro 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.