You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
continuous-integration/drone/push Build encountered an error
Details
|
1 year ago | |
---|---|---|
Verax_API_EF | 1 year ago | |
img | 1 year ago | |
.drone.yml | 1 year ago | |
.gitignore | 1 year ago | |
README.md | 1 year ago |
README.md
Verax API EF
Introduction
Bienvenue sur le projet Verax_API_EF
, une API RESTful développée spécifiquement pour faciliter la communication entre le site web et l'application Android du projet Verax. Cette interface est conçue pour gérer efficacement les articles, les formulaires, et les utilisateurs.
Technologies
- .NET 8: Le framework utilisé pour développer l'application.
- Entity Framework Core: ORM utilisé pour l'accès et la gestion de la base de données.
- SQL Server: Système de gestion de base de données recommandé (modifiable selon vos préférences).
Configuration requise
- .NET 8.
- Un IDE tel que Visual Studio, VS Code avec l'extension C#, ou JetBrains Rider pour le développement.
Installation
- Cloner le projet : Exécutez
git clone https://codefirst.iut.uca.fr/git/Verax/Verax_API_EF.git
pour cloner le dépôt dans votre espace de travail local. - Ouvrez le fichier
Verax_API_EF.sln
avec votre IDE. - Restaurez les packages nécessaires.
- Lancez le projet depuis IDE.
Utilisation
Après avoir lancé l'API, elle sera accessible via http://localhost:5000
par défaut. Voici quelques exemples de requêtes que vous pouvez effectuer :
- Obtenir des articles :
GET /articles
- Ajouter un utilisateur :
POST /user
- Mettre à jour un article :
PUT /article/{id}
- Supprimer un formulaire :
DELETE /formulaire/{id}
Problèmes pouvant être rencontrés
Migration
- Lors de la création de la base de données, l'API s'appuie sur une migration incluse dans le projet
DbContextLib
. Si cette migration est absente, l'API ne fonctionnera pas correctement car la base de données sera vide, entraînant ainsi l'absence de données retournées. En cas de non présence de cette migration, vous devrez décommenter les lignes dans le fichierLibraryContext.cs
du projetDbContextLib
(aux alentours de la ligne 60), puis exécuter les commandes suivantes :
dotnet ef migrations add mrg1 --project DbContextLib --context LibraryContext
PS: N'oubliez pas de supprimer l'ancienne base de données dans le projet API et de recommenter les lignes dans le fichier LibraryContext.cs
Tests Console API
- Pour exécuter les tests console de l'API, assurez-vous au préalable que l'API est en cours d'exécution sur votre machine. Il est également crucial de vérifier que le port utilisé par l'application correspond à celui spécifié dans les configurations des tests. Cette vérification garantit que les tests peuvent interagir correctement avec l'API et fournir des résultats fiables.
Equipe de développement