簡介

API版本控制可以用來在不同的客戶端使用不同的行為。REST框架提供了大量不同的版本設計。
版本控制是由傳入的客戶端請求決定的，並且可能基於請求URL，或者基於請求頭。
有許多有效的方法達到版本控制的目的。特別是為具有多個客戶的長期系統工程進行設計時，沒有版本控制的系統也是可以的。

REST框架的版本控制

當使用版本控制時，request.version屬性（字符串）與客戶端請求的版本一致。
默認情況下，沒有使用版本控制，request.version將會返回None
1 基於不同版本進行不同的行為

def get_serializer_class(self):
    if self.request.version == ‘v1‘:
        return AccountSerializerVersion1
    return AccountSerializer

2 改變URL

from rest_framework.reverse import reverse

reverse(‘bookings-list‘, request=request)

reverse函數將應用於轉換任何請求版本的URL。
- NamespacedVersioning：類似命名空間

‘v1:bookings-list‘
http://example.org/v1/bookings/.

3 QueryParameterVersioning：查詢參數

http://example.org/bookings/?version=1.0

4 版本控制和超鏈接序列化器

def get(self, request):
    queryset = Booking.objects.all()
    serializer = BookingsSerializer(queryset, many=True, context={‘request‘: request})
    return Response({‘all_bookings‘: serializer.data})

版本配置

全局配置

1. 添加配置

 REST_FRAMEWORK = {
              
              .... 
              
              ‘DEFAULT_VERSIONING_CLASS‘:‘rest_framework.versioning.URLPathVersioning‘,
              ‘ALLOWED_VERSIONS‘:[‘v1‘,‘v2‘], # 允許的版本
              ‘VERSION_PARAM‘:‘version‘, # 參數
              ‘DEFAULT_VERSION‘:‘v1‘, # 默認版本
              ....
       }

2. 設置路由 

 BeesCity/urls.py
              urlpatterns = [
                     #url(r‘^admin/‘, admin.site.urls),
                     url(r‘^api/(?P<version>\w+)/‘, include(‘api.urls‘)),
              ]
       
       api/urls.py 
              urlpatterns = [
                     url(r‘^course/$‘, course.CourseView.as_view()),
              ]

3. 傳遞版本信息

http://127.0.0.1:8000/api/v1/course/

4. 獲取版本 

request.version 獲取版本  

局部配置

除非明確設置，否則DEFAULT_VERSIONING_CLASS值為None.此例中request.version將會始終返回None
您還可以在一個單獨的視圖上設置版本控制方案。通常，您不需要這樣做，因為在全局範圍內使用一個版本控制方案更有意義。如果您確實需要這樣做，請使用versioning_class屬性。

from rest_framework.versioning import QueryParameterVersioning

class Course(APIView):
    versioning_class = QueryParameterVersioning

　　這個時候可以用過url傳參的方式來傳遞版本信息，如：

http://127.0.0.1:8000/api/course/?version=1

rest_framework之版本控制