IOS&Andorid API and Django Rest Framework
App API support for Django REST Framework
- Documentation: None
- Format specification: http://jsonapi.org/format/
By default, Django REST Framework will produce a request like:
http://example.com/api/1.0/identities/?page=1
and then the response like:
{
"count": 200,
"msg": "success!",
"data": {
"list": [
{
"id": 3,
"username": "john1",
"full_name": "John Coltrane1"
},
{
"id": 4,
"username": "john2",
"full_name": "John Coltrane2"
},
],
"total_count": 2,
"total_pages": 1
}
}
- if you want get object info, you will produce a request like:
and then the response like:
{
"count": 200,
"msg": "success!",
"data": {
"id": 1,
"username": "john2",
"full_name": "John Coltrane2"
}
}
As a Django REST Framework APP API (short DJA) we are trying to address following goals:
- Support the REST_FRAMEWORK_APPAPI to compliance
- Be as compatible with Django REST Framework as possible
- Have sane defaults to be as easy to pick up as possible
- Be solid and tested with good coverage
- Be performant
- Python (3.5, 3.6, 3.7)
- Django (1.11, 2.1, 2.2)
- Django REST Framework (3.10)
We highly recommend and only officially support the latest patch release of each Python, Django and REST Framework series.
$ pip install djangorestframework-appapi
$ git clone https://github.com/allran/djangorestframework-appapi.git
$ cd django-rest-framework-app-api
$ pip install -e .
It is recommended to create a virtualenv for testing. Assuming it is already installed and activated:
$ git clone https://github.com/allran/djangorestframework-appapi.git
$ cd django-rest-framework-app-api
$ pip install -U -e . -r requirements.txt
$ django-admin migrate --settings=example_project.settings
$ django-admin loaddata drf_example --settings=example_project.settings
$ django-admin runserver --settings=example_project.settings
Browse to http://localhost:8000
It is recommended to create a virtualenv for testing. Assuming it is already installed and activated:
$ pip install -Ur requirements.txt
$ flake8
$ pytest
一. rest_framework_app_api
assumes you are using class-based renderers in Django Rest Framework.
REST_FRAMEWORK = {
'DEFAULT_RENDERER_CLASSES': (
'rest_framework_app_api.renderers.JSONRenderer',
),
}
then you can get the app response data
{
"data": [
{
"id": 1,
"name": "张三"
},
{
"id": 2,
"name": "李四"
}
],
"code": 200,
"msg": "OK"
}
二. rest_framework_app_api
assumes you are using class-based views in Django Rest Framework.
if you use like ListAPIView in from rest_framework.generics import ListAPIView
, please replace with from rest_framework_app_api.generics import ListAPIView
.
from snippets.models import Snippet
from snippets.serializers import SnippetSerializer
from rest_framework_app_api import generics
class SnippetList(generics.ListCreateAPIView):
queryset = Snippet.objects.all()
serializer_class = SnippetSerializer
class SnippetDetail(generics.RetrieveUpdateDestroyAPIView):
queryset = Snippet.objects.all()
serializer_class = SnippetSerializer
- if you use like ListModelMixin in
from rest_framework.mixins import ListModelMixin
, please replace withfrom rest_framework_app_api.mixins import ListModelMixin
.
from snippets.models import Snippet
from snippets.serializers import SnippetSerializer
from rest_framework_app_api import mixins
from rest_framework import generics
class SnippetDetail(mixins.RetrieveModelMixin,
mixins.UpdateModelMixin,
mixins.DestroyModelMixin,
generics.GenericAPIView):
queryset = Snippet.objects.all()
serializer_class = SnippetSerializer
def get(self, request, *args, **kwargs):
return self.retrieve(request, *args, **kwargs)
def put(self, request, *args, **kwargs):
return self.update(request, *args, **kwargs)
def delete(self, request, *args, **kwargs):
return self.destroy(request, *args, **kwargs)
- if you use like APIView in
from rest_framework.views import APIView
, please replace withfrom rest_framework_app_api.views import APIView
.
from snippets.models import Snippet
from snippets.serializers import SnippetSerializer
from rest_framework_app_api.views import APIView
from rest_framework_app_api.response import APIResponse
from rest_framework import status
class SnippetList(APIView):
"""
List all snippets, or create a new snippet.
"""
def get(self, request, format=None):
snippets = Snippet.objects.all()
serializer = SnippetSerializer(snippets, many=True)
return APIResponse(serializer.data)
def post(self, request, format=None):
serializer = SnippetSerializer(data=request.data)
if serializer.is_valid():
serializer.save()
return APIResponse(serializer.data)
return APIResponse(serializer.errors)
class SnippetDetail(APIView):
"""
Retrieve, update or delete a snippet instance.
"""
def get(self, request, pk, format=None):
snippet = self.get_object(pk)
serializer = SnippetSerializer(snippet)
return APIResponse(serializer.data)
def put(self, request, pk, format=None):
snippet = self.get_object(pk)
serializer = SnippetSerializer(snippet, data=request.data)
if serializer.is_valid():
serializer.save()
return APIResponse(serializer.data)
return APIResponse(serializer.errors, code=status.HTTP_400_BAD_REQUEST)
def delete(self, request, pk, format=None):
snippet = self.get_object(pk)
snippet.delete()
return APIResponse(code=status.HTTP_204_NO_CONTENT)
- if you use like ModelViewSet in
from rest_framework.viewsets import ModelViewSet
, please replace withfrom rest_framework_app_api.viewsets import ModelViewSet
.
from snippets.models import Snippet
from rest_framework_app_api import viewsets
class SnippetViewSet(viewsets.ModelViewSet):
queryset = Author.objects.all()
serializer_class = AuthorSerializer
- if you use like Response in
from rest_framework.response import Response
, please replace withfrom rest_framework_app_api.response import APIResponse
.
rest_framework setting
REST_FRAMEWORK = {
'PAGE_SIZE': 10,
# rest_framework custom setting
'EXCEPTION_HANDLER': 'rest_framework_app_api.exceptions.exception_handler',
'DEFAULT_PAGINATION_CLASS': 'rest_framework_app_api.pagination.AppApiPageNumberPagination',
}
rest_framework_app_api setting
REST_FRAMEWORK_APPAPI = {
# rest_framework_app_api code
'DEFAULT_APP_CODE_SUCCESS': 200, # default success code
'DEFAULT_APP_CODE_FAIL': 0, # default error code
# rest_framework_app_api msg
'DEFAULT_APP_MSG_CREAT_SUCCESS': 'create success!',
'DEFAULT_APP_MSG_UPDATE_SUCCESS': 'update success!',
'DEFAULT_APP_MSG_DELETE_SUCCESS': 'delete success!',
'DEFAULT_APP_MSG_SEARCH_SUCCESS': 'get data success!',
'DEFAULT_APP_MSG_SEARCH_NODATA': 'no data!',
'DEFAULT_APP_MSG_UNNONE': 'unknown error!',
}