Área de membros

​

Escopos

​

Modelo

​

Curso

​

Turma

​

Aluno

​

Matrícula

• status é o estado gravado: ACTIVE ou REVOKED (com revokeReason).
• hasAccess diz se o aluno entra agora: matrícula ACTIVE e expiresAt nulo ou futuro. Uma matrícula ACTIVE com acesso vencido vem com hasAccess: false.

​

Progresso

• totalLessons conta só as aulas publicadas, de módulos publicados, que a turma da matrícula vê. Aula em rascunho ou de módulo oculto para a turma fica fora da conta e volta quando fica visível de novo.
• percent é completedLessons / totalLessons × 100, arredondado, e 0 quando não há aulas. É o mesmo percentual que o aluno vê na área de membros.
• completedAt é preenchido quando todas as aulas contadas estão concluídas. Uma aula nova publicada tira o 100%.
• lessons lista cada aula contada, em ordem. A aula que o aluno não abriu vem NOT_STARTED.
• Matrícula revogada ou vencida mantém o progresso gravado, e certificate continua preenchido quando o certificado foi emitido.

​

Sincronizando alunos e progresso

const API = "https://api.gravitypay.app";
const headers = { Authorization: `Bearer ${process.env.GRAVITYPAY_API_KEY}` };

async function get(path) {
  const res = await fetch(`${API}${path}`, { headers });
  if (!res.ok) {
    const { error } = await res.json();
    throw new Error(`${res.status} ${error.type}: ${error.message}`);
  }
  return res.json();
}

// 1. Todos os alunos, com as matrículas e a turma de cada uma.
const alunos = [];
for (let page = 1; ; page++) {
  const lista = await get(`/v1/students?page=${page}&perPage=100`);
  alunos.push(...lista.data);
  if (!lista.hasMore) break;
}

// 2. O progresso de cada aluno com matrícula.
for (const aluno of alunos) {
  if (aluno.enrollments.length === 0) continue;

  const { data } = await get(`/v1/students/${aluno.id}/progress`);
  for (const progresso of data) {
    console.log(aluno.email, progresso.courseId, `${progresso.percent}%`);
  }
}

​

Erros