Skip to content

API: Recurso Estudantes

Daniel Santana edited this page Jul 6, 2019 · 17 revisions

Listar estudantes

Método: GET

URL: /api/students

Implementa

Query String

Nome Tipo Descrição Exemplos
name String Busca por nome. 'LUCAS SOUZA' (nome exato), 'LUCAS%' (começa com 'LUCAS'), '%SOUZA%' (contém 'SOUZA')
registrationNumber String Busca por matrícula '201504940001'
minCrg Number Busca por CRG mínimo 5
maxCrg Number Busca por CRG máximo 8
eqCrg Number Busca por CRG exato 7
course 'cbcc' ou 'cbsi' Busca por curso cbcc
email String Busca por email 'foo@example.com'
isFit Boolean Busca por aptidão 0, 1
isConcluding Boolean Busca por conclusão do curso 0, 1
isActive Boolean Busca por atividade 0, 1
isForming Boolean Busca por formandos 0, 1
isGraduating Boolean Busca por graduação 0, 1
academicHighlight Boolean Busca por destaques acadêmicos 0, 1
cancelled Boolean Busca por alunos cancelados 0, 1
prescribed Boolean Busca por alunos prescritos 1
mailingList User#mailingList Busca por lista de email 'active', 'graduating'...
noDefense Boolean Quando true, retorna apenas alunos sem defesa.

Retorno

Status: 200

Corpo: Array de Student

Ver estudante

Método: GET

URL: /api/students/:id

Implementa

Parâmetros do URL

id: Chave primária do estudante.

Retorno

Status: 200

Corpo: Student

Ordenar estudante

Método: GET

URL: /api/students/?sort=parameter&order=disposition

Implementa

Parâmetros do URL

parameter: name para ordenar pelo nome ou registrationNumber para ordenar pela matrícula.

disposition: asc para ordenar no sentido crescente ou desc para ordenar no sentido decrescente.

Retorno

Status: 200

Corpo: Array de Student

Ver mudanças de listas de email

Método: GET

URL: /api/students/email-changes?mailingList=?

Implementa

Parâmetros do URL

mailingList: active, concluding, freshman.

Retorno

Status: 200

Corpo:

{
  "additions": [
    {
      "id": "identificador",
      "name": "Nome",
      "email": "email@example.com",
      "type":"student|solicitation"
    }
  ],
  "deletions": [
    {
      "id": "identificador",
      "name": "Nome",
      "email": "email@example.com",
      "type":"student|solicitation"
    }
  ]
}

Salvar mudanças de listas de email

Método: POST

URL: /api/students/update-mailing-list

Implementa

Corpo

mailingList: 'active', 'concluding', 'freshman'.

type: 'add', 'remove'

studentIds: Array com identificadores dos estudantes

solicitationIds: Array com identificadores das solicitações

Retorno

Status: 200

Corpo:

{
	"additions": 10,
	"deletions": 5
}

Método: GET

URL: /api/students/:id/concluding-certificate

Implementa

Parâmetros do URL

id: Chave primária do estudante.

Retorno

Status: 200

Corpo: Stream (pdf)

Método: GET

URL: /api/students/:course/attendance-register

Implementa

Parâmetros do URL

course: 'cbcc' ou 'cbsi'.

Retorno

Status: 200

Corpo: Stream (pdf)

Clone this wiki locally