Relatório de notas de quizzes (BETA)

Lista respostas de quiz da sua plataforma, com dados do aluno, desempenho e nome da prova.

Endpoint

GET URL_BASE/partners/reports/student-grades/{developer_token}/{platform_token}

Parâmetros de query

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Tamanho da página entre 2 e 500. Padrão 500.
cursor	string	Não	Próxima página (next_cursor).

Não há filtros de data ou de curso neste endpoint.

Cabeçalhos HTTP

Cabeçalho	Obrigatório	Observação
Accept	Recomendado	application/json.

Exemplo de requisição

GET /api/partners/reports/student-grades/{developer_token}/{platform_token}?limit=100 HTTP/1.1
Accept: application/json

Resposta (200 OK)

Paginação por cursor.

Campos de cada item em data

Campo	Descrição
id	Chave primária de quiz_user_answer.
user_id	UUID do aluno.
student_name	Nome completo quando há sobrenome.
phone, document, email	Contato / documento quando aplicável.
registration_date	Primeira accession_date em assinaturas do aluno no tenant (pacotes da org); pode ser null.
last_access_at	Último login.
quiz_name	Nome do quiz.
performance_percent	Desempenho numérico (arredondado na serialização).
approved	Indicador de aprovação.
answered_at	created_at da resposta.

Exemplo de resposta (trecho)

{
  "data": [
    {
      "id": 891549,
      "user_id": "uuid-do-aluno",
      "student_name": "Nome Sobrenome",
      "phone": null,
      "document": null,
      "email": "[email protected]",
      "registration_date": "2023-01-10 00:00:00",
      "last_access_at": "2025-03-01 12:00:00",
      "quiz_name": "Avaliação final",
      "performance_percent": "85.50",
      "approved": 1,
      "answered_at": "2025-03-15 18:45:00"
    }
  ],
  "path": "/api/partners/reports/student-grades/…",
  "per_page": 100,
  "next_cursor": null,
  "next_page_url": null,
  "prev_cursor": null,
  "prev_page_url": null
}

Na resposta real, path e next_page_url vêm como URL absoluta quando preenchidos.

Quando next_cursor é null, todos os registros couberam na página (limit ≥ total).

Paginação

1. Primeira página: envie limit desejado (ou padrão).

2. Próximas: repita o mesmo limit e envie cursor.

Erros

HTTP	Situação
401	Tokens inválidos ou ausentes.
422	limit fora do intervalo permitido.
403	Possível bloqueio quando User-Agent não é enviado.