5.1 KiB
API - ALL IN !
Contexte : Api pour le projet universitaire de troisieme année (B.U.T Informatique de Clermont-Ferrand) intitulé All In.
Description : Ce dépôt contient l'ensemble du code de l'API pour la partie back-end de l'application ALL IN et la connexion à la base de données.
Utilité : ℹ️ Son rôle est de simplifier le processus de développement des interfaces clients d'All In, que ce soit pour les applications iOS, Android ou tout autre futur client.
Répartition du gitlab
Sources : Code de l'application
Documentation : Documentation de l'application
Technologies
KTOR
- L'API est réalisée avec le framework Ktor, en raison des nombreux avantages qu'il offre. Sa facilité de prise en main, sa légèreté en termes de code, son utilisation d'un langage moderne (Kotlin), ainsi qu'une documentation détaillée et complète du framework.
PostgreSQL
- Pour stocker les données des utilisateurs et des paris, nous utilisons une base de données PostgreSQL sur laquelle l'API s'appuie pour récupérer et enregistrer des données. En raison de sa conformité aux dernières normes SQL, garantissant une compatibilité et une évolutivité optimales, ainsi que de son efficacité à gérer un grand nombre de données.
Ktorm
- Nous avons choisi Ktorm comme ORM pour notre projet en raison de sa compatibilité native avec le framework Ktor. Ktorm permet de mapper notre modèle aux tables de la base de données PostgreSQL de manière fluide et efficace, réduisant les erreurs potentielles liées à la manipulation directe de SQL.
Outils
Pour la partie API, nous utilisons plusieurs outils et méthodes :
Swagger
L'utilisation d'un Swagger dans le développement d'une API facilite la gestion, la documentation et la compréhension des endpoints, optimisant ainsi le processus de création et favorisant une collaboration efficace entre les équipes.
Lien vers le Swagger de l'API All In : Swagger All IN
JWT
Pour renforcer la sécurité en permettant une authentification et une autorisation fiables, nous utilisons la bibliothèque JWT (JSON Web Tokens). Cela garantit l'intégrité des données échangées et facilite la gestion efficace et décentralisée des sessions utilisateur.
DTO et Mapper
Afin de garantir la sécurité des échanges d'informations entre notre application et la base de données, nous avons utiliser des mappers et des DTO. Ils sont essentiels pour une transmission sécurisée des données entre les différentes couches de l'application. Contribuent ainsi à maintenir l'intégrité et la cohérence des données tout au long du processus.
Mock et Base de données
En cas de problème sur le déployement et l'accès à la base de données, des mocks seront utilisables afin de simuler le comportement que pourrait avoir la base de données mais de manière temporaire. Ces mocks permettront de continuer le développement et les tests de l'application sans interruption, garantissant ainsi la productivité. Une fois que l'accès à la base de données sera rétabli, il suffira de désactiver les mocks pour revenir à l'utilisation normale de la base de données PostgreSQL.
Controllers
Notre API est organisée en utilisant une séparation logique des routes par le biais de controllers. Deux controllers principaux structurent notre application :
Controller User 🚶
Ce controller est dédié à l'authentification et aux données liées à l'utilisateur.
Controller BET 💸
Le controller BET gère toutes les opérations liées aux paris. Il permet de récupérer, ajouter, modifier et supprimer des paris.
✅ Cette séparation permet une gestion plus claire et modulaire des fonctionnalités de l'API, facilitant la maintenance et l'extension de notre système.
Déploiement
Le déploiement est réalisé sur Code First via les services Drone et Runner ! 🚀 Lien de l'API sur codefirst : API All In
© AllDev - API