Makina Blog

Dans cet article nous allons voir comment générer dynamiquement des tuiles vectorielles utilisables par la bibliothèque de visualisation mapbox-gl-js à partir de données stockées dans un modèle GeoDjango.

Recette d'une API qui rend happy.

Avec les API REST, développer très rapidement des tests fonctionnels complets qui frôlent les 100% de couverture, c'est possible. Et DRF nous propose une pincée de surcharges aux outils de tests du core de Django pour y parvenir. Cependant, son usage est tellement intuitif que certains points peuvent nous échapper dans la précipitation.

DRF remplit vaillamment son devoir et propose une intégration poussée du versioning d'API. À tel point qu'on est vite perdu dans la multitude de méthodes possibles.

À tort, le versioning est souvent une étape négligée au début d'un projet d'API REST : pas grave, on verra ça vite fait plus tard… Et puis c'est le drame. Ça prend bien plus de temps que prévu. On découvre après coup que ça n'est pas aussi simple et qu'il vaut mieux y être préparé. Qui veut la paix, prépare la guerre !

Après s'être remis de nos émotions avec les routeurs, on va s'accorder une petite trêve avec un thème qui ne déchaîne pas les passions : la négociation de contenu. Pourtant, c'est un passage obligatoire car c'est un élément essentiel aux API REST pour communiquer avec les clients. Allez, courage !

Dernière ligne droite pour les routeurs : après avoir analysé le fonctionnement et l'intégration, c'est au tour de la personnalisation.

Comprendre comment les routeurs fonctionnent est une chose. Savoir s'en servir correctement, c'est mieux ! On va voir que ça n'est pas si simple et que c'est probablement une des parties de DRF la plus étonnante.

Chose promise, chose due : après avoir mis en avant les bienfaits des Viewset, on va plonger dans le côté obscur de la force de DRF : les routeurs.

Dans un précédent article, nous avions évoqué les bonnes pratiques à appliquer avec les serializers et les exceptions. Dans cet article, nous allons nous intéresser plus particulièrement aux Viewset.

Django Rest Framework est une extension à Django pour développer rapidement des API REST robustes au goût du jour. Reprenant la philosophie Django, la prise en main est rapide et efficace. Néanmoins, certaines notions nécessitent une attention plus particulière que nous allons mettre en avant dans cette suite d'articles.

Comment utiliser les bonnes pratiques de développement Python.