Assiduites : Correction doc api

This commit is contained in:
Matthias HARTMANN 2023-07-11 21:36:36 +02:00
parent 70424eba78
commit 007987db88

View File

@ -1437,6 +1437,8 @@ valeurs numériques mais pas JSON compliant à cause des `NaN`.
| *date_fin* | string | date ISO de la fin de la période d'assiduité | | *date_fin* | string | date ISO de la fin de la période d'assiduité |
| *etat* | string | état de l'assiduité (present, absent, retard) | | *etat* | string | état de l'assiduité (present, absent, retard) |
| *desc* | string ou null | description de l'assiduité | | *desc* | string ou null | description de l'assiduité |
| *user_id* | int ou null | utilisateur ayant créé l'assiduité |
| *est_just* | boolean | l'assiduité est-elle justifiée |
| *entry_date* | string | la date d'entrée de l'assiduité | | *entry_date* | string | la date d'entrée de l'assiduité |
> Rappel du format de date ISO : yyyy-mm-jjTHH:MM:SS > Rappel du format de date ISO : yyyy-mm-jjTHH:MM:SS
@ -1463,6 +1465,8 @@ valeurs numériques mais pas JSON compliant à cause des `NaN`.
* `date_debut` (X : date format iso) * `date_debut` (X : date format iso)
* `date_fin` (X : date format iso) * `date_fin` (X : date format iso)
* `formsemestre_id` (X : id du formsemestre) * `formsemestre_id` (X : id du formsemestre)
* `est_just` (v,t,f,vrai,faux,true,false)
* `user_id` (X : id de l'utilisateur)
* **Routes:** * **Routes:**
* `/assiduites/<int:etudid>` * `/assiduites/<int:etudid>`
* `/assiduites/<int:etudid>/query?` * `/assiduites/<int:etudid>/query?`
@ -1484,6 +1488,8 @@ valeurs numériques mais pas JSON compliant à cause des `NaN`.
* `date_debut` (X : date format iso) * `date_debut` (X : date format iso)
* `date_fin` (X : date format iso) * `date_fin` (X : date format iso)
* `formsemestre_id` (X : id du formsemestre) * `formsemestre_id` (X : id du formsemestre)
* `est_just` (v,t,f,vrai,faux,true,false)
* `user_id` (X : id de l'utilisateur)
* `metric` ('compte', 'demi', 'journee', 'heure') * `metric` ('compte', 'demi', 'journee', 'heure')
* **Routes:** * **Routes:**
* `/assiduites/<int:etudid>/count` * `/assiduites/<int:etudid>/count`
@ -1506,6 +1512,8 @@ valeurs numériques mais pas JSON compliant à cause des `NaN`.
* `moduleimpl_id` (X : id du moduleimpl concerné) * `moduleimpl_id` (X : id du moduleimpl concerné)
* `date_debut` (X : date format iso) * `date_debut` (X : date format iso)
* `date_fin` (X : date format iso) * `date_fin` (X : date format iso)
* `est_just` (v,t,f,vrai,faux,true,false)
* `user_id` (X : id de l'utilisateur)
* **Routes:** * **Routes:**
* `/assiduites/formsemestre/<int:formsemestre_id>` * `/assiduites/formsemestre/<int:formsemestre_id>`
* `/assiduites/formsemestre/<int:formsemestre_id>/query?` * `/assiduites/formsemestre/<int:formsemestre_id>/query?`
@ -1526,6 +1534,8 @@ valeurs numériques mais pas JSON compliant à cause des `NaN`.
* `moduleimpl_id` (X : id du moduleimpl concerné) * `moduleimpl_id` (X : id du moduleimpl concerné)
* `date_debut` (X : date format iso) * `date_debut` (X : date format iso)
* `date_fin` (X : date format iso) * `date_fin` (X : date format iso)
* `est_just` (v,t,f,vrai,faux,true,false)
* `user_id` (X : id de l'utilisateur)
* **Routes:** * **Routes:**
* `/assiduites/formsemestre/<int:formsemestre_id>/count` * `/assiduites/formsemestre/<int:formsemestre_id>/count`
* `/assiduites/formsemestre/<int:formsemestre_id>/count/query?` * `/assiduites/formsemestre/<int:formsemestre_id>/count/query?`
@ -1546,12 +1556,14 @@ valeurs numériques mais pas JSON compliant à cause des `NaN`.
* `moduleimpl_id` (X : id du moduleimpl concerné) * `moduleimpl_id` (X : id du moduleimpl concerné)
* `date_debut` (X : date format iso) * `date_debut` (X : date format iso)
* `date_fin` (X : date format iso) * `date_fin` (X : date format iso)
* `est_just` (v,t,f,vrai,faux,true,false)
* `user_id` (X : id de l'utilisateur)
* **Routes:** * **Routes:**
* `/assiduites/group/query?group=` * `/assiduites/group/query?etudids=`
* **Exemple d'utilisation:** * **Exemple d'utilisation:**
* `/assiduites/group/query?group=1,2,3` * `/assiduites/group/query?etudids=1,2,3`
* `/assiduites/group/query?group=1,2,3&etat=retard` * `/assiduites/group/query?etudids=1,2,3&etat=retard`
* `/assiduites/group/query?group=1,2,3&moduleimpl=1` * `/assiduites/group/query?etudids=1,2,3&moduleimpl=1`
* **Résultat:** * **Résultat:**
```json ```json
{ {
@ -1570,12 +1582,13 @@ valeurs numériques mais pas JSON compliant à cause des `NaN`.
```json ```json
[ [
{ {
"etudid":<int>,
"date_debut": <string>, "date_debut": <string>,
"date_fin": <string>, "date_fin": <string>,
"etat": <string>, "etat": <string>,
"etudid":<int> "moduleimpl_id"?: <int>,
"moduleimpl_id"?: <int> "desc"?:<string>,
"desc"?:<string>
}, },
... ...
] ]
@ -1603,7 +1616,7 @@ valeurs numériques mais pas JSON compliant à cause des `NaN`.
"date_debut": <string>, "date_debut": <string>,
"date_fin": <string>, "date_fin": <string>,
"etat": <string>, "etat": <string>,
"moduleimpl_id"?: <int> "moduleimpl_id"?: <int>,
"desc"?:<string> "desc"?:<string>
}, },
... ...
@ -1630,7 +1643,7 @@ valeurs numériques mais pas JSON compliant à cause des `NaN`.
{ {
"etat": <string>, "etat": <string>,
"moduleimpl_id": <int>, "moduleimpl_id": <int>,
"desc" : <string> "desc" : <string>,
} }
``` ```
@ -1864,11 +1877,25 @@ valeurs numériques mais pas JSON compliant à cause des `NaN`.
#### **justificatif-list** #### **justificatif-list**
* **Méthode:** GET * **Méthode:** GET
* **Permission: `ScoView`** * **Permission: `ScoView` / `ScoJustifView`**
* Si `ScoView` : retourne uniquement les fichiers fourni par le même utilisateur
* Si `ScoJustifView` : retourne tous les fichiers
* **Paramètres:** `justif_id` * **Paramètres:** `justif_id`
* **Routes:** `/justificatif/<int:justif_id>/list` * **Routes:** `/justificatif/<int:justif_id>/list`
* **Exemple d'utilisation:** `/api/justificatif/1/list` * **Exemple d'utilisation:** `/api/justificatif/1/list`
* **Résultat:** Retourne la liste des fichiers archivés une erreur si l'id n'est pas connu * **Résultat:**
```json
{
"filenames" : [
<str>,
...
],
"total": <int>
}
```
* Le total indique le nombre total de fichiers (visibles ou non)
* **Exemple de résultat:** [justificatif-list.json](samples/sample_justificatif_list.json.md) * **Exemple de résultat:** [justificatif-list.json](samples/sample_justificatif_list.json.md)
#### **justificatif-justifies** #### **justificatif-justifies**