django-repos-cadre: api de gestion des versions

Mise à JOUR:

gestion des versions est maintenant correctement pris en charge.

---

Il y a quelques réponses à partir de votre lien:

Nous avons trouvé qu'il est possible et utile de mettre la version dans l'URL. Il
le rend facile de dire ce que vous utilisez un coup d'œil. Nous n'alias /foo
d' /foo/(dernières versions) pour la facilité d'utilisation, plus court /plus propre Url,
etc, que l'on a accepté de répondre suggère.
En gardant la compatibilité descendante forever est souvent un coût prohibitif et/ou très difficile. Nous préférons donner un préavis de
la dépréciation, les redirections comme suggéré ici, de la documentation et d'autres
les mécanismes.

Nous avons donc profité de cette approche, en plus de permettre aux clients de spécifier la version en-tête de la requête (X-Version), voici comment nous avons procédé:

Structure latérale de l'API app:

.
├── __init__.py
├── middlewares.py
├── urls.py
├── v1
│   ├── __init__.py
│   ├── account
│   │   ├── __init__.py
│   │   ├── serializers.py
│   │   └── views.py
│   └── urls.py
└── v2
    ├── __init__.py
    ├── account
    │   ├── __init__.py
    │   ├── serializers.py
    │   └── views.py
    └── urls.py

projet urls.py:

url(r'^api/', include('project.api.urls', namespace='api')),

api app niveau urls.py:

from django.conf.urls import *

urlpatterns = patterns('',
    url(r'', include('project.api.v2.urls', namespace='default')),
    url(r'^v1/', include('project.api.v1.urls', namespace='v1')),
)

niveau de version urls.py

from django.conf.urls import *
from .account import views as account_views
from rest_framework.routers import DefaultRouter

router = DefaultRouter()
router.register('account', account_views.AccountView)
router.register('myaccount', account_views.MyAccountView)
urlpatterns = router.urls

créer un middleware pour passer le code, la modification de la path_info, veuillez noter qu'il y est une mise en garde de l'espace de nom ("api") défini dans le projet de l'url de niveau n'est pas flexible et doit être connue dans le middleware:

from django.core.urlresolvers import resolve
from django.core.urlresolvers import reverse


class VersionSwitch(object):

    def process_request(self, request):
        r = resolve(request.path_info)
        version = request.META.get('HTTP_X_VERSION', False)
        if r.namespace.startswith('api:') and version:
            old_version = r.namespace.split(':')[-1]
            request.path_info = reverse('{}:{}'.format(r.namespace.replace(old_version, version), r.url_name), args=r.args, kwargs=r.kwargs)

Exemple d'url:

curl -H "X-Version: v1" http://your.domain:8000/api/myaccount/