Bonnes pratiques API REST Heroku

Fondements :

1. Séparer les préocupations

 

2. TLS/SSL est requis

 

3. Gestion des versions par un header accept

Exemple de mise en place

 

Exemple de test via httpie:

http --debug GET http://127.0.0.1:8000/blogs/1/articles/ 'Accept: application/json; version=1;'

http --debug GET http://127.0.0.1:8000/blogs/1/articles/ 'Accept: application/json; version=2;'

 

 

- Ne pas fournir de version par défaut !

- Comment faire pour switcher d'une version à l'autre ?

Dans la view, récupérer la version dans la requête puis appeler les bons sérializers et modèles

=> Maintenir plusieurs versions de serializers et de models

 

 

4. Support du header ETags pour la mise en cache