Skip to content

angestephane/robust-nodeJS-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NodeJS Robuste API

NodeJS robuste API est un boilerplate pour la conception des API RESTfull. Cette API repose sur une architecture totalement maintenable et réutilisable.

Les fonctionnalités complètes de cet exemple de projet écrit en NodeJS

  • Créer un projet
  • Lister tous les produits avec une option de pagination
  • Obtenir un produit spécifique à partir de son ID
  • Modifier un produit
  • Supprimer un produit
  • Créer un admin
  • Connecter un admin en utilisant JWT
  • Documentation de l'API avec Swagger.

Tech Stack

Server:

  • NodeJS
  • ExpressJS

Database:

  • Mongoose
  • MongoDB

Schema & validation des requêtes:

  • Joi

Documentation:

  • Swagger

Installation

Vous devez disposer de NodeJS && npm installé sur votre machine

  1. Cloner ou télécharger le projet. Si vous décidez de cloner le projet exécutez les commandes en dessous, dans un dossier créer préalablement.
git clone https://github.com/angestephane/robust-nodeJS-api.git .
  1. Installer les dépendances
npm install
  1. Exécution
npm run dev

Utilisation

Dans un fichier .env que vous allez créer :

  1. Ajoutez les variables d'environnement pour la connexion à la base de données : DB_URL

  2. Définissez un port d'accès au server, sinon le port par défaut sera 3000 : PORT

  3. Explorer le code et modifier les schemas et modèles en fonction de vos besoins. L'API s'adaptera.

Documentation

L'API présenté dans ce projet à été document avec Swagger.
Cette documentation est accessible uniquement en mode dev
Pour consulter la documentation :

  1. exécuter le projet :
npm run dev
  1. Vous vous rendez ensuite sur : http://localhost:3002/api-docs/

Feedback

Je serai ravi d'avoir vos remarques et avis sur un point particulier de l'API.

License

MIT

About

Robuste API nodeJS. Totalement réutilisable pour tout type de projet NodeJS avec Javascript

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors