Mudanças

Ir para navegação Ir para pesquisar
Adicionado API de consulta de curso
Linha 206: Linha 206:     
}
 
}
 +
 +
=== CURSOS: Obtendo dados: ===
 +
Busca os cursos cadastrados na base de dados de acordo com os parâmetros informados na query string.
 +
 +
Método: GET
 +
 +
(base)/gestaoescolar/services/v1/cursos?codigoUnidadeEnsino=1&periodoLetivo=2022
 +
 +
====Query String (Parâmetros)====
 +
{| class="wikitable"
 +
|Obrigatório
 +
|Campo
 +
|Descrição
 +
|-
 +
|Sim
 +
|codigoUnidadeEnsino
 +
|Código  da unidade de ensino
 +
|-
 +
|Sim
 +
|periodoLetivo
 +
|Descrição  do período letivo, deve ter o mesmo valor da descrição definida na Gestão  Escolar. Por exemplo,  se deve  considerar apenas matrículas do período letivo de 2012, deve ser informado  “2012”, exatamente como está cadastrado na gestão Escolar
 +
|-
 +
|
 +
|Nome  do turma
 +
|Texto  para localizar parcialmente os registros usando a descrição da turma
 +
|-
 +
|
 +
|codigo/sigla  do curso
 +
|Código  do curso que deve ter as matrículas retorna
 +
|-
 +
|
 +
|numeroSequenciaSerie
 +
|Representa  um número inteiro que define a ordem de sequência de uma série no curso. EX:
 +
 +
Ao definir o curso Robótica com três séries (1º, 2º, 3º), no cadastro de  séries da Gestão Escolar é definida a ordem de sequência de cada série para o  curso, para que seja possível saber para qual série o Aluno vai ao fim  de cada período letivo.
 +
 +
Informando  o número exato, será retornada as matrículas especificas daquela série
 +
|-
 +
|
 +
|nomeCurso
 +
|Nome  do curso para verificação se existe no cadastro de curso
 +
|-
 +
|
 +
|Status
 +
|Situação  possíveis para busca da turma (VIGENTE, EM_FORMACAO,ENCERRADA)
 +
|-
 +
|
 +
|codigoIntegracaoCurso
 +
|Identificador  de integração entre o Sistema da ASAS e o da Ultramax no cadastro de cursos  de EAD. Vai servir também para identicar qualquer outro sistema de terceiro  que utilizar a API de integração de cursos para criar cursos no Gestão  Escolar
 +
 +
Informando  o código, irá retornar a série correspondente cadastrada
 +
|}
 +
 +
====Respostas esperadas====
 +
Status 200: : OK
 +
 +
Status 412: : Caso não seja informado o código da unidade de negócio e a descrição do período letivo
 +
 +
Resposta: Conjunto de registros
 +
 +
{| class="wikitable"
 +
|'''Atributo'''
 +
|'''Descrição'''
 +
|Tipo
 +
|Tamanho
 +
|-
 +
|'''codigoUnidade'''
 +
|Código  da unidade de ensino
 +
|Texto
 +
|
 +
|-
 +
|'''periodoLeletivo'''
 +
|Descrição  do período Letivo atual
 +
|Texto
 +
|
 +
|-
 +
|'''codigoCurso'''
 +
|Código  do curso
 +
|Texto
 +
|
 +
|-
 +
|'''nomeCurso'''
 +
|Nome do  curso
 +
|Texto
 +
|
 +
|-
 +
|'''numeroSerieDeMatricula'''
 +
|Numero  inteiro indicando com a sequência da série no curso que a matrícula deve ser  feita. Ex: um curso que tenha
 +
|Inteiro
 +
|
 +
|-
 +
|'''nomeSerie'''
 +
|Nome da  série
 +
|Texto
 +
|
 +
|-
 +
|'''nomeTurma'''
 +
|Nome da turma (ficará vazio caso não tenha uma turma associada ainda no período
 +
|Texto
 +
|
 +
|}
    
===Manutenção de alunos===
 
===Manutenção de alunos===
privado
180

edições

Menu de navegação