« Documentation de l'API Onche.org » : différence entre les versions
Aucun résumé des modifications |
|||
| (7 versions intermédiaires par 3 utilisateurs non affichées) | |||
| Ligne 1 : | Ligne 1 : | ||
L''''API''' (''interface de programmation d'application'') du forum '''[[Onche.org]]''', est utilisée de manière analogue à l'[[Documentation de l'API Jeuxvideo.com|API de Jeuxvideo.com]], permettant d'interagir facilement avec le [[forum]] depuis une application, un site, ou n'importe quels autres programmes extérieurs. | |||
== Fonctionnement général du site == | == Fonctionnement général du site == | ||
Le site utilise | Le site utilise principalement 3 bibliothèques pour son fonctionnement.<ref name=":0">https://onche.org/js/license.txt</ref> | ||
* [https://jquery.com/ ''jQuery''] pour la majorité des appels à l'API.<ref name=":0" /> | |||
* [https://github.com/js-cookie/js-cookie ''JavaScript Cookie''] pour la gestion des cookies.<ref name=":0" /> | |||
* [https://fr.react.dev/ ''React''] pour la conception de l'interface utilisateur.<ref name=":0" /> | |||
L'inclusion simultanée de React et jQuery est une pratique peu commune. Cela s'avère problématique du fait des disparités de fonctionnement entre ces deux bibliothèques, pouvant engendrer une multitude de bugs, une baisse de performance notable et compliquer la mise en œuvre de nouvelles fonctionnalités, ainsi que la maintenance des fonctionnalités existantes.<ref>https://stackoverflow.com/a/51304632</ref> | |||
== API == | |||
=== <u>Endpoints</u> === | |||
Il y a différents niveaux d'accès en fonction du status de l'utilisateur, le serveur évalue le niveau d'accès en fonction du cookie '''''auth'''''. | |||
==== <u>Disponibles pour tous les utilisateurs</u> ==== | |||
{| class="wikitable" | |||
|+ | |||
!Description | |||
!URL | |||
!METHOD | |||
!BODY | |||
|- | |||
|JSON des stickers | |||
|stickers/favorites | |||
|GET | |||
| | |||
|- | |||
|notifications (forum + mp) JSON | |||
|notifications/count | |||
|GET | |||
| | |||
|- | |||
|liste utilisateurs online | |||
|user/logged | |||
|GET | |||
| | |||
|} | |||
= | ==== <u>Réservés aux modos et aux admins</u> ==== | ||
=== Réservés aux modos et aux admins === | |||
{| class="wikitable" | {| class="wikitable" | ||
|+ | |+ | ||
| Ligne 50 : | Ligne 82 : | ||
| | | | ||
|} | |} | ||
{{SectionRéférences}} | |||
[[Catégorie:Onche.org]] | |||
Dernière version du 7 juillet 2025 à 21:41
L'API (interface de programmation d'application) du forum Onche.org, est utilisée de manière analogue à l'API de Jeuxvideo.com, permettant d'interagir facilement avec le forum depuis une application, un site, ou n'importe quels autres programmes extérieurs.
Fonctionnement général du siteModifier
Le site utilise principalement 3 bibliothèques pour son fonctionnement.[1]
- jQuery pour la majorité des appels à l'API.[1]
- JavaScript Cookie pour la gestion des cookies.[1]
- React pour la conception de l'interface utilisateur.[1]
L'inclusion simultanée de React et jQuery est une pratique peu commune. Cela s'avère problématique du fait des disparités de fonctionnement entre ces deux bibliothèques, pouvant engendrer une multitude de bugs, une baisse de performance notable et compliquer la mise en œuvre de nouvelles fonctionnalités, ainsi que la maintenance des fonctionnalités existantes.[2]
APIModifier
EndpointsModifier
Il y a différents niveaux d'accès en fonction du status de l'utilisateur, le serveur évalue le niveau d'accès en fonction du cookie auth.
Disponibles pour tous les utilisateursModifier
| Description | URL | METHOD | BODY |
|---|---|---|---|
| JSON des stickers | stickers/favorites | GET | |
| notifications (forum + mp) JSON | notifications/count | GET | |
| liste utilisateurs online | user/logged | GET |
Réservés aux modos et aux adminsModifier
| Description | URL | METHOD | BODY |
|---|---|---|---|
| admin/unbanip | POST | ||
| admin/banip | POST | ||
| admin/unban | POST | ||
| admin/ban | POST | ||
| admin/jail | POST | ||
| admin/unjail | POST | ||
| message/remove/ | POST |