Doc API. Closes #1031.

app/api/etudiants.py

@@ -523,7 +523,7 @@ def etudiant_create(force=False):
 
     L'étudiant créé n'est pas inscrit à un semestre.
 
-    Champs requis: nom, prenom (sauf si config sans prénom), dept (string:acronyme)
+    Champs requis: civilite ('M', 'F' ou 'X'), dept (string:acronyme), nom, prenom (sauf si config sans prénom).
     """
     args = request.get_json(force=True)  # may raise 400 Bad Request
     dept = args.get("dept", None)

app/models/etudiants.py

@@ -256,6 +256,8 @@ class Identite(models.ScoDocModel):
         """
         check_etud_duplicate_code(args, "code_nip", dest_url=None)
         check_etud_duplicate_code(args, "code_ine", dest_url=None)
+        if not "civilite" in args:
+            raise ScoValueError("civilite manquante")
         if not "dept_id" in args:
             if "dept" in args:
                 departement = Departement.query.filter_by(acronym=args["dept"]).first()