Django Ninja 1.1 est sorti
par Makersquad ·
Date de sortie : 7 décembre 2023
Mis à jour le 17 novembre 2026
Release officielle : Django Ninja 1.1.0
Django Ninja 1.1 est une version d’entretien. Elle permet de plafonner la limite de la pagination, corrige le schéma OpenAPI des relations many-to-many à clé UUID, corrige la génération des champs optionnels de ModelSchema et relève le minimum de Django déclaré de 2.2 à 3.1. Les nouveautés d’authentification asynchrone et de protection CSRF automatique, parfois attribuées à cette version, datent de la 1.0.
Les nouveautés principales
Limite maximale pour la pagination
Le limit demandé par le client à LimitOffsetPagination peut désormais être plafonné par le serveur. Le plafond se règle dans settings.py :
NINJA_PAGINATION_MAX_LIMIT = 100
Avec ce réglage, une requête qui demande limit=1000 aboutit et ne renvoie que 100 éléments.
Support de UUID
Le schéma OpenAPI des relations many-to-many dont la clé est un UUID est désormais généré. Il corrige une erreur signalée sur une telle relation : l’affichage du schéma OpenAPI échouait avec une KeyError.
Champs optionnels avec fields_optional = '__all__'
Avec Meta.fields_optional = '__all__' sur un ModelSchema, les champs n’étaient pas générés. C’est corrigé.
Version minimale de Django
Django Ninja 1.1 relève le minimum de Django déclaré par le paquet, de Django >=2.2 à Django >=3.1, et supprime le code de compatibilité avec les versions antérieures. Django 2.2, 3.0 et 4.0 sortent de la matrice de tests et Django 5.0 y entre. Les versions de Python ne changent pas : le paquet déclare toujours requires_python >=3.7, et Python 3.7 reste testé.
Documentation de la protection CSRF
La documentation de la protection CSRF est plus complète. Le comportement lui-même, automatique avec l’authentification par cookie, vient de la 1.0.
À retenir
Django Ninja 1.1 ne change pas l’API de façon visible. Elle ajuste la pagination, la génération de schémas à partir des modèles Django et le minimum de Django (3.1) : relisez la limite maximale de pagination si vos clients demandent de grandes pages.