Om na te gaan wat een gebruiker doet, filter je de logs op route: het API-endpoint dat de app aanroept. Sommige routes spreken voor zich, zoals files/. Andere zijn minder vanzelfsprekend: een student die een of meer feedbackverzoeken binnen dezelfde activiteit start, vind je onder journal_access_nodes/. Deze pagina geeft per onderdeel de meest gebruikte routes, zoals ze in de keuzelijst van het filter staan.
Elk verzoek heeft een methode. Filter op methode en route samen om bijvoorbeeld alleen nieuwe entries te zien.
| Methode |
Betekenis |
GET |
Iets bekeken of geladen |
POST |
Iets aangemaakt, of een actie gestart zoals inloggen, kopiëren of exporteren |
PATCH of PUT |
Iets gewijzigd, ook indienen en terugzetten naar concept |
DELETE |
Iets verwijderd |
- Kies de route die eindigt op de naam van het onderdeel, zoals
feedback_forms/. Je ziet dan alle verzoeken op dat onderdeel, ook die op één specifiek item.
(?P<pk>[^/.]+) in een route staat voor het id van één item. journals/(?P<pk>[^/.]+)/ is bijvoorbeeld één collectie. Het id zelf zie je in het Volledig pad van het verzoek.- Routes die eindigen op
\.(?P<format>[a-z0-9]+)/? kun je negeren: eJournal gebruikt ze zelf niet.
- Kies je meer routes, dan zie je de verzoeken op elk van die routes.
- Het filter zoekt op een deel van de route, dus een route kan ook andere routes tonen. Controleer daarom de kolom Route in de resultaten. De meest verwarrende:
feedback_forms/ toont ook assessment_feedback_forms/templates/ toont ook feedback_templates/entries/ toont ook teacher_entries/participations/ toont ook assignment_participations/ (notificaties dempen voor een collectiesjabloon)groups/ toont ook category_groups/token/ toont ook otp_token/nodes/ toont alle routes die op nodes/ eindigen, zoals preset_nodes/ en journal_access_nodes/
| Onderdeel |
Route |
Wat er gebeurt |
| Inloggen met wachtwoord |
token/ |
POST bij inloggen met gebruikersnaam en wachtwoord. Bij een geslaagde login staat de gebruiker bij het verzoek. |
| Sessie verlengen |
token/refresh/ |
POST, automatisch zodra de toegangstoken van een ingelogde gebruiker verloopt. |
| Uitloggen |
token/blacklist/ |
POST bij uitloggen. |
| Inloggen met een eenmalig wachtwoord (OTP) |
otp_token/login/ |
POST met de code uit de e-mail. otp_token/send_otp_token/ verstuurt die e-mail. |
| Inloggen via SURFconext of een andere OIDC-koppeling |
auth/oidc/<slug:identifier>/ |
GET wanneer de gebruiker op de inlogknop klikt. Bij terugkeer van SURFconext volgt oidc/callback/. |
| Starten vanuit het LMS |
lti/login/?, daarna lti/launch/? |
Bij het openen van eJournal vanuit het LMS. |
| Inloggen als een andere gebruiker |
users/login_as/ |
POST wanneer een beheerder inlogt als een andere gebruiker. |
| Onderdeel |
Route |
Wat er gebeurt |
| Cursus, programma, persoonlijke ruimte |
layers/ |
GET openen, POST aanmaken, PATCH wijzigen, DELETE verwijderen. |
| Collectiesjabloon |
assignments/ |
GET openen, POST aanmaken, PATCH wijzigen. assignments/copyable/ laadt de collectiesjablonen die de gebruiker kan kopiëren, assignments/(?P<pk>[^/.]+)/copy/ kopieert er een. |
| Collectie |
journals/ |
GET op journals/(?P<pk>[^/.]+)/ opent een collectie. Met join/, leave/ en add_members/ daaronder wordt iemand lid, verlaat iemand de collectie of worden leden toegevoegd. |
Een inrichter maakt en wijzigt deze onderdelen (POST, PATCH, DELETE). Studenten en feedbackgevers gebruiken ze in de collecties.
| Onderdeel |
Route |
| Entry-sjabloon |
templates/ |
| Geplande activiteit |
preset_nodes/ |
| Feedbacksjabloon |
feedback_templates/ |
| Rubric |
rubrics/ |
| Categorie, categoriegroep |
categories/, category_groups/ |
| Categorieniveau |
category_levels/ |
| Subcategorie |
subcategory/ |
| Feedbackinstellingen |
feedback_settings/ |
| Collectiesjablooninstellingen, waaronder de collectierichtlijnen |
collection_template_settings/ (PATCH bij opslaan) |
| Collectierichtlijnen in een collectie |
collection_guidelines/ (alleen GET: de richtlijnen en de voortgang daarop worden geladen) |
| Onderdeel |
Route |
Wat er gebeurt |
| Entry aanmaken, opslaan en indienen |
journal_entry_links/ |
POST maakt een entry aan, PATCH slaat wijzigingen op. submit/ dient de entry in, convert_to_draft/ zet hem terug naar concept. DELETE haalt de entry uit de collectie. |
| Entry bekijken en verwijderen |
entries/ |
GET opent een entry of zijn eerdere versies, DELETE verwijdert de entry. |
| Inhoud van een veld |
contents/ |
DELETE wist de inhoud van één veld van een entry. |
| Docentenentry |
teacher_entries/ |
POST aanmaken, PATCH wijzigen, DELETE verwijderen. |
| Inhoudsopgave |
nodes/ |
GET laadt de inhoudsopgave van een collectie of collectiesjabloon. reorder_journal_nodes/ en reorder_assignment_nodes/ wijzigen de volgorde. |
| Onderdeel |
Route |
Wat er gebeurt |
| Feedbackverzoek starten |
journal_access_nodes/ |
POST wanneer een student een of meer feedbackverzoeken binnen dezelfde activiteit start. Voor elke feedbackgever komt er een feedbackformulier bij. |
| Feedbackformulier |
feedback_forms/ |
Feedbackverzoeken, mondelinge feedback, peerfeedback en zelfreflecties. GET openen, PATCH opslaan. list_feedback_requests/ en list_received_feedback/ laden de overzichten. |
| Activiteitsbeoordeling |
assessment_feedback_forms/ |
GET openen, PATCH opslaan. |
| Collectiebeoordeling |
assessments/ |
GET openen, PATCH opslaan, DELETE verwijderen. assessments/export_all/ exporteert alle collectiebeoordelingen. |
| Opmerkingen |
comments/ |
POST plaatsen, PATCH wijzigen, DELETE verwijderen. |
| Rubric invullen |
criterion_submissions/, rubric_submissions/ |
PATCH op criterion_submissions/ vult een criterium in, DELETE op rubric_submissions/ wist een ingevulde rubric. |
| Categorieniveaufeedback |
category_level_feedback/ |
PATCH opslaan, DELETE verwijderen. |
| Waarderingen publiceren |
journals/publish_grades/ |
PATCH wanneer een docent de waarderingen van een of meer collecties publiceert. |
| Onderdeel |
Route |
Wat er gebeurt |
| Inschrijving in een cursus of programma |
participations/ |
POST toevoegen, PATCH wijzigen, DELETE verwijderen. |
| Groep |
groups/ |
POST aanmaken, PATCH wijzigen, DELETE verwijderen. |
| Groepsleden |
members/ |
POST toevoegen, DELETE verwijderen. |
| Gebruiker |
users/ |
PATCH op users/(?P<pk>[^/.]+)/ wijzigt het profiel, users/password/ het wachtwoord. |
| Onderdeel |
Route |
Wat er gebeurt |
| Inlevering uit het LMS |
lms_api/ |
Een inlevering uit het LMS in een entry zetten (set_assignment_submission_and_store/) of eruit verwijderen (delete_submission/). |
| Toegang tot het LMS geven |
lms/authenticate/? |
De gebruiker geeft eJournal toegang tot zijn LMS-account. |
| Waarderingen naar het LMS sturen |
assignments/(?P<pk>[^/.]+)/sync_grades/ |
PATCH stuurt alle waarderingen van een collectiesjabloon dat aan het LMS is gekoppeld naar het LMS. |
| Onderdeel |
Route |
Wat er gebeurt |
| Bestanden |
files/ |
POST bij het uploaden van een bestand. convert_to_pdf/ zet een Word-bestand om om het te tonen. |