API de Integração - Documentação | Sistema Acadêmico SWA.JACAD

Alunos

Retorna uma lista de alunos de um período letivo liberado.
Caso a chamada contenha mais de 300 objetos em seu retorno, será retornado os 300 objetos mais o campo nextPage com o link para os próximos 300 objetos.
Método: POST
Resposta: JSON/XML

Parâmetro	Obrigatório	Tipo	Descrição
idPeriodoLetivo	Sim	java.lang.Integer	Código Período Letivo.
idDisciplina	Não	java.lang.Integer	Código Disciplina
idCurso	Não	java.lang.Integer	Código Curso
idDisciplinaProfessor	Não	java.lang.Integer	Código Disciplina Professor
idAluno	Não	java.lang.Integer	Código Aluno
ra	Não	java.lang.String	RA
format	Não	java.lang.String	Formato do retorno (JSON/XML) default JSON
offset	Não	java.lang.Integer	offset (número de registros a serem pulados na realização da consulta)

URIs de acesso

http://187.60.217.18:8080/academico/ead/api/public/v1/alunos

Formato do objeto de retorno

{
  "nextPage (String)": null,
  "result (ArrayList)": null,
  "id_org (Integer)": null
}

Professores

Retorna uma lista de professores responsaveis e professores auxiliares de um período letivo liberado.
Caso a chamada contenha mais de 300 objetos em seu retorno, será retornado os 300 objetos mais o campo nextPage com o link para os próximos 300 objetos.
Método: POST
Resposta: JSON/XML

Parâmetro	Obrigatório	Tipo	Descrição
idPeriodoLetivo	Sim	java.lang.Integer	Código Período Letivo.
idDisciplinaProfessor	Não	java.lang.Integer	Código Disciplina Professor
idDisciplina	Não	java.lang.Integer	Código Disciplina
idCurso	Não	java.lang.Integer	Código Curso
idProfessor	Não	java.lang.Integer	Código Professor
format	Não	java.lang.String	Formato do retorno (JSON/XML) default JSON
offset	Não	java.lang.Integer	offset (número de registros a serem pulados na realização da consulta)

URIs de acesso

http://187.60.217.18:8080/academico/ead/api/public/v1/professores

Formato do objeto de retorno

{
  "idProfessor (Integer)": null,
  "nome (String)": null,
  "cpf (String)": null,
  "rg (String)": null,
  "titulacao (String)": null,
  "escolaridade (String)": null,
  "posGraduacao (String)": null,
  "situacaoDocente (String)": null,
  "dataSituacaoDocente (Date)": null,
  "idInep (Long)": null,
  "grauGraduacao (String)": null,
  "email (String)": null,
  "dataNascimento (Date)": null,
  "id_org (Integer)": null
}

Períodos Letivos habilitados

Retorna uma lista com os períodos letivos habilitados para integração.
Método: POST
Resposta: JSON/XML

Parâmetro	Obrigatório	Tipo	Descrição
idPeriodoLetivo	Não	java.lang.Integer	Código Período Letivo.
idOrg	Não	java.lang.Integer	Código da Organização
format	Não	java.lang.String	Formato do retorno (JSON/XML) default JSON

URIs de acesso

http://187.60.217.18:8080/academico/ead/api/public/v1/periodos

Formato do objeto de retorno

{
  "idPeriodoLetivo (Integer)": null,
  "descricao (String)": null,
  "descricaoEspecial (String)": null,
  "dataInicio (Date)": null,
  "dataTermino (Date)": null,
  "situacao (String)": null,
  "idOrg (Integer)": null,
  "isPeriodoAtual (Integer)": null,
  "ano (Integer)": null,
  "idProximoPeriodoLetivo (Integer)": null,
  "id_org (Integer)": null
}

Cursos Ofertados

Retorna uma lista com os cursos ofertados em um período letivo liberado.
Caso a chamada contenha mais de 300 objetos em seu retorno, será retornado os 300 objetos mais o campo nextPage com o link para os próximos 300 objetos.
Método: POST
Resposta: JSON/XML

Parâmetro	Obrigatório	Tipo	Descrição
idPeriodoLetivo	Sim	java.lang.Integer	Código Período Letivo.
idDisciplinaProfessor	Não	java.lang.Integer	Código da Disciplina Professor (Curso)
idTurma	Não	java.lang.Integer	Código da Turma
descricaoDisciplina	Não	java.lang.String	Descrição da Disciplina
nomeReduzidoDisciplina	Não	java.lang.String	Nome Reduzido da Disciplina
format	Não	java.lang.String	Formato do retorno (JSON/XML) default JSON
offset	Não	java.lang.Integer	offset (número de registros a serem pulados na realização da consulta)

URIs de acesso

http://187.60.217.18:8080/academico/ead/api/public/v1/cursos

Formato do objeto de retorno

{
  "nextPage (String)": null,
  "result (ArrayList)": null,
  "id_org (Integer)": null
}

Inscrições por Curso

Retorna uma lista contendo as inscrições de um determinado curso, contendo inscrições de ALUNO, PROFESSOR e PROFESSOR AUXILIAR
Método: POST
Resposta: JSON/XML

Parâmetro	Obrigatório	Tipo	Descrição
idDisciplinaProfessor	Sim	java.lang.Integer	Código Disciplina Professor
roles	Não	[Ljava.lang.String;	Array de String contendo o filtro de Papeis ['ALUNO','PROFESSOR','PROFESSOR_AUXILIAR']
idProfessor	Não	java.lang.Integer	Código Professor
idMatriculaDisciplina	Não	java.lang.Integer	Código Matrícula Disciplina (Inscrição do Aluno)
idAluno	Não	java.lang.Integer	Código Aluno
format	Não	java.lang.String	Formato do retorno (JSON/XML) default JSON

URIs de acesso

http://187.60.217.18:8080/academico/ead/api/public/v1/curso/inscricoes

Formato do objeto de retorno

{
  "idMatriculaDisciplina (Integer)": null,
  "idAluno (Integer)": null,
  "ra (String)": null,
  "idDisciplinaProfessor (Integer)": null,
  "idDisciplinaProfessorAuxiliar (Integer)": null,
  "idProfessor (Integer)": null,
  "idCurso (Integer)": null,
  "idDisciplina (Integer)": null,
  "idPeriodoLetivo (Integer)": null,
  "role (String)": null,
  "id_org (Integer)": null
}

Atualizar nota do aluno

Atualiza a nota de um aluno em uma avaliação especifica.
Método: POST
Resposta: Retornará o status 200 OK caso tenha ocorrido todo o processamento de forma correta

Parâmetro	Obrigatório	Tipo	Descrição
idDisciplinaProfessor	Sim	java.lang.Integer	Código Disciplina Professor
idMatriculaDisciplina	Sim	java.lang.Integer	Código Matrícula Disciplina (Inscrição do Aluno)
identificadorAvaliacao	Sim	java.lang.String	Identificador da Avaliação
nota	Sim	java.lang.Double	Nota do Aluno na Avaliação
format	Não	java.lang.String	Formato do retorno (JSON/XML) default JSON

URIs de acesso

http://187.60.217.18:8080/academico/ead/api/public/v1/curso/inscricao/nota/lancar

Atualizar nota do aluno (Lote)

Atualiza em lote a nota de varios alunos, através de um array de objetos em formato json. Todos os parametros são obrigatórios.

Para este método, além do token, é necessário informar também no HEADER do request o Content-Type com valor application/json

Atenção: São aceitos no máximo 50 objetos por chamada
Método: POST
Resposta: Retornará o status 200 OK caso tenha ocorrido todo o processamento de forma correta ou um json com os objetos que apresentaram erros com o field 'erro' pupulado

Parâmetro	Obrigatório	Tipo	Descrição
matriculas	Sim	java.util.List	Lista de Objetos

URIs de acesso

http://187.60.217.18:8080/academico/ead/api/public/v1/curso/inscricao/nota/lote/lancar

Formato do objeto de entrada

{
  "idDisciplinaProfessor (Integer)": null,
  "idMatriculaDisciplina (Integer)": null,
  "identificadorAvaliacao (String)": null,
  "nota (Double)": null,
  "erro (String)": null,
  "id_org (Integer)": null
}

Formato do objeto de retorno

{
  "idDisciplinaProfessor (Integer)": null,
  "idMatriculaDisciplina (Integer)": null,
  "identificadorAvaliacao (String)": null,
  "nota (Double)": null,
  "erro (String)": null,
  "id_org (Integer)": null
}

Consulta alunos sem nota

Consulta os aluns que não possuem nota em uma avaliação especifica.
Método: POST
Resposta: Retornará o status 200 OK caso tenha ocorrido todo o processamento de forma correta

Parâmetro	Obrigatório	Tipo	Descrição
idDisciplinaProfessor	Não	java.lang.Integer	Código Disciplina Professor
idTurma	Não	java.lang.Integer	Código Turma
identificadorAvaliacao	Sim	java.lang.String	Identificador da Avaliação
format	Não	java.lang.String	Formato do retorno (JSON/XML) default JSON

URIs de acesso

http://187.60.217.18:8080/academico/ead/api/public/v1/alunos/sem/nota