Voortgang
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
- Trainingen (GET /trainings)
- Lessen (GET /lessons)
- Leden (GET /members)
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.