Express REST API example
 
Go to file
sundowndev 4cb06a5324 Email field 2018-11-15 19:26:57 +01:00
app Email field 2018-11-15 19:26:57 +01:00
config Database config 2018-11-13 18:49:14 +01:00
docs Docs 2018-11-14 18:16:00 +01:00
.eslintignore Install eslint 2018-11-13 11:15:47 +01:00
.eslintrc.json Install eslint 2018-11-13 11:15:47 +01:00
.gitignore gitignore 2018-11-12 16:26:33 +01:00
.travis.yml Travis config 2018-11-13 18:46:36 +01:00
README.md Doc 2018-11-12 14:20:40 +01:00
index.js Error handling middleware 2018-11-14 18:16:33 +01:00
package-lock.json Install Joi package 2018-11-13 18:49:39 +01:00
package.json Test script 2018-11-14 18:16:16 +01:00

README.md

API node

RESTful API based on Expressjs.

Overview

Features

  • Sign up
  • Sign in
  • CRUD notes
  • reset password (optional)

Models

  • User: firstname, lastname, email, password
  • Note: title, text, author

Specs

Pourvoir s'inscrire, se connecter, réinitialiser mot de passe (non connecté) :

  • POST /auth/register (firstname, lastname, email, password) (201 created)
  • POST /auth/login (email, password) (200 ok avec en body le user et en header le token d'authentification)
  • POST /auth/rester-password (email) (optionnel si tu te sens pas chaud) (200 ok)

Pouvoir voir / modifier / supprimer son profil (connecté):

  • PUT /user/me (tous les champs sauf password) (200 ok avec en body le user après édition)
  • PUT /user/me (si tu vois password et new password, ou mets une autre route si tu veux) (200 ok avec le user après édition mais sans mot de passe bien sûr)
  • DELETE /users/me (supprimer le profil) (204 no content, car le user est supprimé et tu ne me renvoi rien)
  • GET /users/me (renvoi le user) (200 ok avec en body le user) pouvoir gérer les notes (connecté)
  • POST /notes (title optionnel, text optionnel, lié a user connecté) (201 creatred)
  • PUT /notes/id (title optionnel, text optionnel) (200 ok avec en body la noté modifiée)
  • DELETE /notes/id (supprimer la note) (204 no content)
  • GET /user/me/ notes (toutes notes du user connecté)
  • GET /notes/id (get la note de cet id si elle appartient au user connecté)

Finito ! C'est un crud avec un minimum de vérif qui sont :

  • Est-ce que le user est connecté ou non
  • Est-ce que le user est propriétaire de la ressource qu'il modifie ou supprime

C'est tout ce qu'il y a besoin de vérifier.

Pour tout ce qui est erreur il n'y a que 4 règles à respecter :

  • Pas le droit car pas connecté : 401
  • Pas le droit car connecté mais ne t'appartient pas : 403
  • Ressource n'existe pas : 404
  • Erreur de validation (si tu veux en faire) : 400 bad request