Students

Obtém todos os alunos

get

Este endpoint retorna todos os alunos cadastrados na plataforma, independentemente de possuírem uma assinatura ativa ou não. Por padrão, as assinaturas não são carregadas. Para incluí-las na resposta, utilize o parâmetro with=subscriptions na query string, permitindo o carregamento das assinaturas de cada aluno.

Authorizations
HTTPRequired
Query parameters
withstringOptional

Permite incluir as assinaturas. Ex: with=subscriptions. Caso não seja informado, as assinaturas não serão carregadas.

Responses
chevron-right
200

The request has succeeded.

application/json
get
/students

Criar novo aluno

post

Este endpoint realiza apenas o cadastro do aluno, não criando nenhuma assinatura. A assinatura deve ser criada posteriormente, por meio do endpoint específico de criação de assinaturas, utilizando o ID do aluno previamente cadastrado.

Caso seja informado um e-mail já existente, será lançado uma exception StudentAlreadyExistsException.

Authorizations
HTTPRequired
Body
idstringRead-onlyRequired

ID do aluno

first_namestringRequired

Nome

last_nameany ofOptional

Sobrenome

stringOptional
or
nullOptional
full_namestringRead-onlyRequired

Nome completo

emailstringRequired

E-mail

photo_urlany ofRead-onlyOptional

URL da foto

stringOptional
or
nullOptional
phoneany ofOptional

Telefone

stringOptional
or
nullOptional
genreany ofRead-onlyOptional

Gênero

stringOptional
or
nullOptional
birthany ofOptional

Data de nascimento

stringOptional
or
nullOptional
documentany ofOptional

Documento do aluno

stringOptional
or
nullOptional
reference_idany ofOptional

Identificador externo do aluno (Usado para integrações externas)

stringOptional
or
nullOptional
created_atstringRead-onlyRequired

Data de criação

updated_atstringRead-onlyRequired

Data da última atualização

Responses
post
/students

Obtem aluno por document

get

Este endpoint retorna um aluno pelo seu document, desde que esteja cadastrado na plataforma, independentemente de possuir ou não uma assinatura ativa.

Caso o aluno não seja encontrado, será lançada a exceção StudentNotFoundException.

Authorizations
HTTPRequired
Path parameters
documentstringRequired
Responses
chevron-right
200

The request has succeeded.

application/json
get
/students/document/{document}

Obtém aluno por e-mail

get

Este endpoint retorna um aluno com base em seu e-mail, desde que esteja cadastrado na plataforma, independentemente de possuir uma assinatura ativa ou não. Neste caso, as assinaturas são sempre carregadas na resposta.

Caso o aluno não seja encontrado, será lançada a exceção StudentNotFoundException.

Authorizations
HTTPRequired
Path parameters
emailstringRequired
Responses
chevron-right
200

The request has succeeded.

application/json
get
/students/email/{email}

Criar link mágico por email

post

Este endpoint gera um link mágico utilizando o próprio e-mail do aluno.

Authorizations
HTTPRequired
Path parameters
emailstringRequired
Body
expire_inintegerRequired

Tempo de expiração em segundos

Default: 5
urlstringRead-onlyRequired

Link mágico para acesso à plataforma

Responses
chevron-right
200

The request has succeeded.

application/json
post
/students/email/{email}/magic-link

Obtem aluno por reference_id

get

Este endpoint retorna um aluno pelo seu reference_id, desde que esteja cadastrado na plataforma, independentemente de possuir ou não uma assinatura ativa.

Caso o aluno não seja encontrado, será lançada a exceção StudentNotFoundException.

Authorizations
HTTPRequired
Path parameters
reference_idstringRequired
Responses
chevron-right
200

The request has succeeded.

application/json
get
/students/reference/{reference_id}

Obtém aluno por ID

get

Este endpoint retorna um aluno com base em seu ID, desde que esteja cadastrado na plataforma, independentemente de possuir uma assinatura ativa ou não. Neste caso, as assinaturas são sempre carregadas na resposta.

Caso o aluno não seja encontrado, será lançada a exceção StudentNotFoundException.

Authorizations
HTTPRequired
Path parameters
student_idstringRequired
Responses
chevron-right
200

The request has succeeded.

application/json
get
/students/{student_id}

Excluir o cadastro de aluno

delete

Este endpoint realiza a exclusão de um aluno na plataforma. Caso o aluno possua assinaturas, elas também serão excluídas.

Caso o aluno não seja encontrado, será lançada a exceção StudentNotFoundException.

Authorizations
HTTPRequired
Path parameters
student_idstringRequired
Responses
delete
/students/{student_id}

No content

Criar link mágico por ID

post

Este endpoint gera um link mágico utilizando o próprio ID do aluno.

Authorizations
HTTPRequired
Path parameters
student_idstringRequired
Body
expire_inintegerRequired

Tempo de expiração em segundos

Default: 5
urlstringRead-onlyRequired

Link mágico para acesso à plataforma

Responses
chevron-right
200

The request has succeeded.

application/json
post
/students/{student_id}/magic-link

Obtém todos os produtos relacionados a um aluno (Assinaturas).

get

Este endpoint retorna todos os produtos (Assinataruas) relacionados a um aluno pelo seu ID.

Caso o aluno não possua nenhum produto (Assinatura), será retornada uma lista vazia.

Authorizations
HTTPRequired
Path parameters
student_idstringRequired
Responses
chevron-right
200

The request has succeeded.

application/json
get
/students/{student_id}/products

Criar uma assinatura

post

Este endpoint cria uma assinatura para um aluno.

Caso seja informado um ID de aluno inexistente, será lançada a exceção StudentNotFoundException.

Caso seja informado um ID de produto inexistente, será lançada a exceção ProductNotFoundException.

Caso o aluno já possua essa assinatura, será lançada a exceção SubscriptionAlreadyExistsException.

Authorizations
HTTPRequired
Path parameters
student_idstringRequired
Body
product_idstringRequired

ID do produto

accession_datestringRequired

Data de adesão YYYY-MM-DD

expiration_datestringRequired

Data de expiração YYYY-MM-DD

Responses
post
/students/{student_id}/products

Obtém um produto de um aluno por ID (Assinatura)

get

Este endpoint retorna um produto (Assinatura) específico de um aluno.

Caso o aluno não seja encontrado, será lançada a exceção StudentNotFoundException.

Caso o produto não seja encontrado, será lançada a exceção ProductNotFoundException

Caso o produto/aluno informado não corresponda a uma assinatura, será lançada a exceção SubscriptionNotFoundException.

Authorizations
HTTPRequired
Path parameters
student_idstringRequired
product_idstringRequired
Responses
chevron-right
200

The request has succeeded.

application/json
get
/students/{student_id}/products/{product_id}

Excluír o produto de um aluno (Assinatura)

delete

Este endpoint realiza a exclusão de uma assinatura de um aluno.

Caso o aluno não seja encontrado, será lançada a exceção StudentNotFoundException.

Caso a produto não seja encontrado, será lançada a exceção ProductNotFoundException.

Caso o produto/aluno informado não corresponda a uma assinatura, será lançada a exceção SubscriptionNotFoundException.

Authorizations
HTTPRequired
Path parameters
student_idstringRequired
product_idstringRequired
Responses
delete
/students/{student_id}/products/{product_id}

No content

Obtém as pontuações de um aluno.

get

Este endpoint retorna as pontuações de um aluno.

Caso o aluno não seja encontrado, será lançada a exceção StudentNotFoundException.

Authorizations
HTTPRequired
Path parameters
student_idstringRequired
Responses
chevron-right
200

The request has succeeded.

application/json
get
/students/{student_id}/scores

Atualiza as pontuações de um aluno.

put

Este endpoint atualiza as pontuações do aluno

Caso o aluno não seja encontrado, será lançada a exceção StudentNotFoundException.

Authorizations
HTTPRequired
Path parameters
student_idstringRequired
Body
scoreintegerRequired

Valor da pontuação

Default: 0
postsintegerRead-onlyRequiredDefault: 0
commentsintegerRead-onlyRequiredDefault: 0
repliesintegerRead-onlyRequiredDefault: 0
Responses
chevron-right
200

The request has succeeded.

application/json
put
/students/{student_id}/scores

Last updated