Pular para o conteúdo principal

​
Módulos

Módulos são as disciplinas, matérias ou unidades individuais que compõem um curso. Crie os módulos no nível da instituição e, em seguida, vincule-os a um ou mais cursos.

​
O objeto módulo

{
  "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "code": "CS101",
  "name": "Introduction to Programming",
  "description": "Fundamentals of programming using Python.",
  "syllabus": "Variables, control flow, functions, OOP basics.",
  "workload": 80,
  "credits": 4,
  "modality": "hybrid",
  "level": "undergraduate",
  "is_active": true,
  "is_required": true,
  "institution": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Federal University of Technology"
  }
}
CampoTipoDescrição
uuidstringIdentificador único
codestringCódigo do módulo (único por instituição, máx. 20 caracteres)
namestringNome do módulo (máx. 150 caracteres)
descriptionstringDescrição resumida
syllabusstringConteúdo completo da ementa
workloadintegerCarga horária total (sem sinal)
creditsintegerCréditos acadêmicos (sem sinal)
modalityenumin_person, online, hybrid
levelenumundergraduate, graduate, technical, open
is_activebooleanIndica se o módulo está ativo no momento
is_requiredbooleanIndica se o módulo é obrigatório no curso

​
Listar módulos

GET /modules

curl "https://api.dokstamp.eu/modules?where[level]=undergraduate&sort[column]=name&sort[order]=asc" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "X-Tenant: {TENANT}"

​
Criar um módulo

POST /modules
ParâmetroTipoObrigatórioDescrição
namestringSimNome do módulo
institution_uuidstringSimUUID da instituição pai
codestringNãoCódigo do módulo (único por instituição)
descriptionstringNãoDescrição resumida
syllabusstringNãoEmenta completa
workloadintegerNãoTotal de horas de contato
creditsintegerNãoCréditos acadêmicos
modalityenumNãoin_person, online, hybrid
levelenumNãoundergraduate, graduate, technical, open
is_activebooleanNãoPadrão: true
is_requiredbooleanNãoPadrão: false
curl -X POST https://api.dokstamp.eu/modules \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Tenant: {TENANT}" \
  -d '{
    "name": "Introduction to Programming",
    "code": "CS101",
    "institution_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "workload": 80,
    "credits": 4,
    "modality": "hybrid",
    "level": "undergraduate",
    "is_active": true,
    "is_required": true
  }'

​
Obter, atualizar, excluir

GET    /modules/{uuid}
PATCH  /modules/{uuid}
PUT    /modules/{uuid}
DELETE /modules/{uuid}
DELETE /modules/batch/destroy
Após criar os módulos, vincule-os a um curso utilizando POST /courses/{uuid}/attach/modules. Consulte Módulos do Curso.