KazV2

KAZ/KazV2

History

hpl f796f01d40 Modifications qui seront validées : modifié : ../app.py nouveau fichier : cloud.py nouveau fichier : common_imports.py nouveau fichier : config.py nouveau fichier : dns.py nouveau fichier : kaz_user.py nouveau fichier : ldap.py nouveau fichier : mattermost.py nouveau fichier : paheko.py nouveau fichier : password.py nouveau fichier : quota.py nouveau fichier : sympa.py nouveau fichier : test.py		2024-08-20 01:53:17 +02:00
..
source	Modifications qui seront validées :	2024-08-20 01:53:17 +02:00
.env	.env apikaz	2024-07-08 20:34:53 +02:00
docker-compose.yml	supp version de chaque docker-compose et vire le proxy nginx	2024-08-16 23:51:23 +02:00
Readme.txt	first commit	2024-06-03 18:43:35 +02:00

Readme.txt

yo, ceci est l'api de kaz !

https://apikaz.kazkouil.fr/

Je pars de ça: python api + docker-compose: https://dev.to/alissonzampietro/the-amazing-journey-of-docker-compose-17lj

Pour la doc:
module Flask + flask-restful + flasgger
https://stackoverflow.com/questions/75840827/how-to-properly-generate-a-documentation-with-swagger-for-flask
https://medium.com/@DanKaranja/building-api-documentation-in-flask-with-swagger-a-step-by-step-guide-59a453509e2f
https://apidog.com/blog/what-is-flasgger/

autre piste: abandonnée pour l'instant. trop jeune ?
Documentation (OpenApi remplace swagger)
https://pypi.org/project/flask-openapi3/


TODO: 
* sécurisation de l'API : un token ? otp ?
* sécurité: comment différencier les rôles admin (tout faire) et kaznaute (changer uniquement ses coordonnées, relancer son site propre web, ...)
* pourquoi pas une seule classe pour plusieurs api ? (par exemple LDAP, pas mal de factorisation possible)
* pourquoi pas de donnée dans le body ? (au lieu des variables dans l'url). par ex, pour le message du mail.