Naar hoofdinhoud

Voortgang

GET https://scintillating-wolf-799.eu-west-1.convex.site/v1/progress

Per lid en per les of die is afgerond, en wanneer. Zonder userId loopt dit over de hele omgeving, wat bij veel leden een lange lijst is.

Rechten: learning:read. Deze gegevens gaan over personen.

Voortgang is één regel per lid per les, met of die is afgerond en wanneer. Daarmee bouw je een overzicht van wie waar is blijven steken, wat vaak nuttiger is dan het aantal afgeronde trainingen.

Zonder userId loopt dit over de hele omgeving, en dat is bij veel leden een lange lijst. Gaat het je om één persoon, geef dan userId mee; dat scheelt je het doorbladeren van alles.

Een regel ontstaat zodra een lid een les afrondt of een quiz inlevert. Een les alleen bekijken levert nog geen regel op, dus lessen waar iemand nog niets mee deed staan er niet in. Wil je een percentage berekenen, zet het aantal afgeronde regels dan af tegen lessonCount uit de trainingen.

Parameters

Naam Uitleg
userId Alleen de voortgang van dit lid.
limit Aantal items per pagina, 1 tot en met 500. Standaard 100. Een waarde daarbuiten geeft een fout in plaats van een stille correctie.
cursor De nextCursor uit het vorige antwoord. Blijf doorbladeren tot nextCursor null is, ook als een pagina niet vol zit.

Voorbeeld

curl "https://scintillating-wolf-799.eu-west-1.convex.site/v1/progress" \
  -H "Authorization: Bearer <je sleutel>"

Antwoord

{
  "items": [
    {
      "userId": "qd7…",
      "trainingId": "ps7…",
      "lessonId": "pl4…",
      "completed": true,
      "completedAt": 1767398400000,
      "createdAt": 1767312000000
    }
  ],
  "nextCursor": null
}

Velden

Veld Type Betekenis
userId string Het lid.
trainingId string De training.
lessonId string De les.
completed boolean Of de les is afgerond.
completedAt getal of null Wanneer dat gebeurde.
createdAt getal Wanneer deze regel ontstond. Er is één regel per lid per les; bij een latere wijziging blijft dit moment staan.

Veelgestelde vragen

Waarom mist een lid dat net begonnen is?
Er komt pas een regel zodra iemand een les afrondt of een quiz inlevert. Alleen kijken telt niet.
Kan ik zien hoeveel tijd iemand aan een les besteedde?
Nee. Je ziet alleen of een les is afgerond en op welk moment dat gebeurde.

Hierna nodig

Werkt je aanroep niet zoals verwacht, kijk dan bij de foutcodes en wat ze betekenen. Heb je nog geen sleutel, dan legt de kennisbank uit hoe je er een aanmaakt.