Cursos

Um curso representa um programa acadêmico — uma graduação, diploma, curso profissional ou programa de treinamento. Ele conecta módulos em um currículo estruturado e fornece o contexto acadêmico para os certificados.

O objeto curso

{
  "uuid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "code": "BCS-2024",
  "name": "Bachelor of Computer Science",
  "description": "A 4-year undergraduate program in computer science.",
  "workload_hours": 3200,
  "area": "Technology",
  "version": "2024.1",
  "status": "active",
  "institution": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Federal University of Technology"
  },
  "organization": null,
  "created_at": "2024-01-15T10:00:00.000000Z"
}

Campo	Tipo	Descrição
`uuid`	string	Identificador único
`code`	string	Código interno do curso
`name`	string	Nome do curso (máx. 255 caracteres)
`description`	string	Descrição do programa
`workload_hours`	integer	Total de horas do programa
`area`	string	Área do conhecimento (ex.: Tecnologia, Saúde)
`version`	string	Versão do currículo
`status`	enum	`draft`, `active`, `archived`
`institution`	object	Instituição pai
`organization`	object\|null	Subunidade opcional (faculdade/departamento)

Listar cursos

GET /courses

curl "https://api.dokstamp.com/courses?where[status]=active&sort[column]=name" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "X-Tenant: {TENANT}"

Criar um curso

POST /courses

Parâmetro	Tipo	Obrigatório	Descrição
`name`	string	Sim	Nome do curso
`institution_uuid`	string	Sim	UUID da instituição pai
`code`	string	Não	Código interno
`description`	string	Não	Descrição do programa
`workload_hours`	integer	Não	Total de horas do programa
`area`	string	Não	Área do conhecimento
`version`	string	Não	Versão do currículo
`status`	enum	Não	`draft` (padrão), `active`, `archived`
`organization_uuid`	string	Não	UUID da subunidade (faculdade/departamento)

curl -X POST https://api.dokstamp.com/courses \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Tenant: {TENANT}" \
  -d '{
    "name": "Bachelor of Computer Science",
    "code": "BCS-2024",
    "institution_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "workload_hours": 3200,
    "area": "Technology",
    "version": "2024.1",
    "status": "active"
  }'

Resposta 201:

{
  "data": {
    "uuid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "name": "Bachelor of Computer Science",
    "status": "active",
    ...
  }
}

Obter, atualizar, excluir

GET    /courses/{uuid}
PATCH  /courses/{uuid}
PUT    /courses/{uuid}
DELETE /courses/{uuid}
DELETE /courses/batch/destroy

Transições de status

Status	Significado
`draft`	O curso está sendo configurado — ainda não aceita matrículas
`active`	O curso está ativo — certificados podem ser emitidos
`archived`	O curso não é mais oferecido — os registros históricos são mantidos

Próximos passos para cursos

Após criar um curso:

Vincular módulos → Módulos do Curso
Criar grupos de módulos → Grupos de Módulos
Criar turmas → Turmas
Emitir certificados → Certificados

Primeiros Passos

Conceitos Fundamentais

Autenticação

Instituições

Organizações

Cursos

Módulos

Estudantes

Matrículas

Certificados

Modelos de Certificado

Arquivos

Guias

Guia de Integração

Cursos

Cursos

O objeto curso

Listar cursos

Criar um curso

Obter, atualizar, excluir

Transições de status

Próximos passos para cursos

​Cursos

​O objeto curso

​Listar cursos

​Criar um curso

​Obter, atualizar, excluir

​Transições de status

​Próximos passos para cursos

Cursos

O objeto curso

Listar cursos

Criar um curso

Obter, atualizar, excluir

Transições de status

Próximos passos para cursos