Spécifications de l'API incomplètes (et ticket incomplet !) #266

Closed
opened 2022-01-08 00:53:28 +01:00 by viennet · 0 comments
Owner

Dans les specs de l'API, https://scodoc.org/ScoDoc9API, il reste des incohérences et les valeurs fournies ne sont pas suffisamment spécifiées.

  • /api/departements/<str:dept>/etudiants/liste/<int:formsemestre_id> le paramètre ne peut pas être optionnel. Le département ne sert à rien.
    Par ailleurs "liste des étudiants " ne dit pas ce qu'on renvoie précisément.

  • Le concept de "semestre actifs" n'est pas défini. Remplacer par "semestre en cours" ou "semestre non verrouillés", suivant les cas.

  • utiliser des noms en franglais. Par exemple, liste_semestres_actifs a donc été remplacé par formsemestres/current

  • utiliser formsemestreet non semestre.

  • /api/formations/formsemestre => /api/formsemestre

etc . Revoir l'ensemble...

Dans les specs de l'API, https://scodoc.org/ScoDoc9API, il reste des incohérences et les valeurs fournies ne sont pas suffisamment spécifiées. - `/api/departements/<str:dept>/etudiants/liste/<int:formsemestre_id>` le paramètre ne peut pas être optionnel. Le département ne sert à rien. Par ailleurs "liste des étudiants " ne dit pas ce qu'on renvoie précisément. - Le concept de "semestre actifs" n'est pas défini. Remplacer par "semestre en cours" ou "semestre non verrouillés", suivant les cas. - utiliser des noms en franglais. Par exemple, `liste_semestres_actifs` a donc été remplacé par `formsemestres/current` - utiliser `formsemestre`et non `semestre`. - `/api/formations/formsemestre` => `/api/formsemestre` etc . Revoir l'ensemble...
viennet added the
API
label 2022-01-08 00:53:35 +01:00
Sign in to join this conversation.
No Milestone
No project
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: ScoDoc/ScoDoc#266
No description provided.