Quickstart

我們將創(chuàng)建一個簡單的API惩激,以允許管理員用戶查看和編輯系統(tǒng)中的用戶和組

Project setup

創(chuàng)建一個叫tutorial的新Django項目,然后啟動一個名為quickstart的新應用程序蒜哀。

# Create the project directory
mkdir tutorial
cd tutorial

# Create a virtualenv to isolate our package dependencies locally
virtualenv env
source env/bin/activate  # On Windows use `env\Scripts\activate`

# Install Django and Django REST framework into the virtualenv
pip install django
pip install djangorestframework

# Set up a new project with a single application
django-admin.py startproject tutorial .  # Note the trailing '.' character
cd tutorial
django-admin.py startapp quickstart
cd ..

現(xiàn)在第一次同步你的數據庫:

python manage.py migrate

隨后,我們還將創(chuàng)建一個名為admin的初始用戶县耽,密碼為password123至耻。 我們稍后將在該示例中驗證該用戶亲怠。

python manage.py createsuperuser

一旦你創(chuàng)建了一個數據庫所计,初始用戶創(chuàng)建完成并準備好了一切,那么就打開應用程序的目錄团秽,我們將要開始編碼了...

Serializers

首先我們要定義一些序列化程序主胧。 創(chuàng)建一個名為tutorial / quickstart / serializers.py的新模塊,用于我們的數據表示习勤。

from django.contrib.auth.models import User, Group
from rest_framework import serializers


class UserSerializer(serializers.HyperlinkedModelSerializer):
    class Meta:
        model = User
        fields = ('url', 'username', 'email', 'groups')


class GroupSerializer(serializers.HyperlinkedModelSerializer):
    class Meta:
        model = Group
        fields = ('url', 'name')

請注意踪栋,在這個例子中,我們使用超鏈接關系图毕,HyperlinkedModelSerializer夷都。 你還可以使用主鍵和各種其他關系,但超鏈接是很好的符合RESTful的設計予颤。

Views

是的囤官,我們最好再寫一些views。 打開tutorial / quickstart / views.py并開始打字了蛤虐。

from django.contrib.auth.models import User, Group
from rest_framework import viewsets
from tutorial.quickstart.serializers import UserSerializer, GroupSerializer


class UserViewSet(viewsets.ModelViewSet):
    """
    API endpoint that allows users to be viewed or edited.
    """
    queryset = User.objects.all().order_by('-date_joined')
    serializer_class = UserSerializer


class GroupViewSet(viewsets.ModelViewSet):
    """
    API endpoint that allows groups to be viewed or edited.
    """
    queryset = Group.objects.all()
    serializer_class = GroupSerializer

我們將所有常見行為分組到ViewSets的類中党饮,而不是寫多個視圖。
如果需要驳庭,我們當然可以容易地劃分為獨立的視圖刑顺,但是使用viewsets可以使視圖邏輯組織更良好、簡潔饲常。

URLs

好了蹲堂,我們現(xiàn)在開始在tutorial/urls.py中寫API 相關的URLs了。

from django.conf.urls import url, include
from rest_framework import routers
from tutorial.quickstart import views

router = routers.DefaultRouter()
router.register(r'users', views.UserViewSet)
router.register(r'groups', views.GroupViewSet)

# Wire up our API using automatic URL routing.
# Additionally, we include login URLs for the browsable API.
urlpatterns = [
    url(r'^', include(router.urls)),
    url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework'))
]

因為我們使用的是viewsets 而不是views贝淤,所以我們可以簡單地使用路由器類注冊viewsets 來自動生成API的URL 配置柒竞。

再次說一下,如果我們需要對API URL進行更多的控制霹娄,我們可以簡單地將其下拉到使用常規(guī)基于類的視圖能犯,并明確地編寫URL 配置。

最后犬耻,使用可瀏覽的API講包含默認的登錄和注銷視圖踩晶。 當然,這是可選的枕磁,但如果你的API需要身份驗證渡蜻,并且您想要使用可瀏覽的API,那么它們很有用。

Settings

我們也會想要一些全局設置茸苇。 例如我們想分頁排苍,我們希望我們的API只能由管理員使用。 這個設置模塊就在tutorial / settings.py中

INSTALLED_APPS = (
    ...
    'rest_framework',
)

REST_FRAMEWORK = {
    'DEFAULT_PERMISSION_CLASSES': [
        'rest_framework.permissions.IsAdminUser',
    ],
    'PAGE_SIZE': 10
}

好了学密,我們完成了淘衙。

Testing our API

現(xiàn)在,我們可以測試我們構建的API了腻暮。 從命令行啟動服務器彤守。

python manage.py runserver

我們現(xiàn)在可以從命令行訪問我們的API,使用諸如curl ...

bash: curl -H 'Accept: application/json; indent=4' -u admin:password123 http://127.0.0.1:8000/users/
{
    "count": 2,
    "next": null,
    "previous": null,
    "results": [
        {
            "email": "admin@example.com",
            "groups": [],
            "url": "http://127.0.0.1:8000/users/1/",
            "username": "admin"
        },
        {
            "email": "tom@example.com",
            "groups": [                ],
            "url": "http://127.0.0.1:8000/users/2/",
            "username": "tom"
        }
    ]
}

或使用httpie哭靖,命令行工具...

bash: http -a admin:password123 http://127.0.0.1:8000/users/

HTTP/1.1 200 OK
...
{
    "count": 2,
    "next": null,
    "previous": null,
    "results": [
        {
            "email": "admin@example.com",
            "groups": [],
            "url": "http://localhost:8000/users/1/",
            "username": "paul"
        },
        {
            "email": "tom@example.com",
            "groups": [                ],
            "url": "http://127.0.0.1:8000/users/2/",
            "username": "tom"
        }
    ]
}

或直接通過瀏覽器具垫,跳轉到URL http://127.0.0.1:8000 / users / ...

image.png

如果您正在使用瀏覽器,請確保使用右上角的控件進行登錄试幽。

太好了筝蚕,那很簡單!

如果你想更深入地了解REST框架铺坞,請閱讀the tutorial 或者 API guide起宽。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市康震,隨后出現(xiàn)的幾起案子燎含,更是在濱河造成了極大的恐慌,老刑警劉巖腿短,帶你破解...
    沈念sama閱讀 218,525評論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件屏箍,死亡現(xiàn)場離奇詭異,居然都是意外死亡橘忱,警方通過查閱死者的電腦和手機赴魁,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,203評論 3 395
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來钝诚,“玉大人颖御,你說我怎么就攤上這事∧模” “怎么了潘拱?”我有些...
    開封第一講書人閱讀 164,862評論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長拧略。 經常有香客問我芦岂,道長,這世上最難降的妖魔是什么垫蛆? 我笑而不...
    開封第一講書人閱讀 58,728評論 1 294
  • 正文 為了忘掉前任禽最,我火速辦了婚禮润樱,結果婚禮上局嘁,老公的妹妹穿的比我還像新娘汇跨。我一直安慰自己承粤,他們只是感情好,可當我...
    茶點故事閱讀 67,743評論 6 392
  • 文/花漫 我一把揭開白布懦趋。 她就那樣靜靜地躺著晾虑,像睡著了一般。 火紅的嫁衣襯著肌膚如雪愕够。 梳的紋絲不亂的頭發(fā)上走贪,一...
    開封第一講書人閱讀 51,590評論 1 305
  • 那天佛猛,我揣著相機與錄音惑芭,去河邊找鬼。 笑死继找,一個胖子當著我的面吹牛遂跟,可吹牛的內容都是我干的。 我是一名探鬼主播婴渡,決...
    沈念sama閱讀 40,330評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼幻锁,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了边臼?” 一聲冷哼從身側響起哄尔,我...
    開封第一講書人閱讀 39,244評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎柠并,沒想到半個月后岭接,有當地人在樹林里發(fā)現(xiàn)了一具尸體,經...
    沈念sama閱讀 45,693評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡臼予,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,885評論 3 336
  • 正文 我和宋清朗相戀三年鸣戴,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片粘拾。...
    茶點故事閱讀 40,001評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡窄锅,死狀恐怖,靈堂內的尸體忽然破棺而出缰雇,到底是詐尸還是另有隱情入偷,我是刑警寧澤,帶...
    沈念sama閱讀 35,723評論 5 346
  • 正文 年R本政府宣布械哟,位于F島的核電站疏之,受9級特大地震影響,放射性物質發(fā)生泄漏戒良。R本人自食惡果不足惜体捏,卻給世界環(huán)境...
    茶點故事閱讀 41,343評論 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧几缭,春花似錦河泳、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,919評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至某抓,卻和暖如春纸兔,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背否副。 一陣腳步聲響...
    開封第一講書人閱讀 33,042評論 1 270
  • 我被黑心中介騙來泰國打工汉矿, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人备禀。 一個月前我還...
    沈念sama閱讀 48,191評論 3 370
  • 正文 我出身青樓洲拇,卻偏偏與公主長得像,于是被迫代替她去往敵國和親曲尸。 傳聞我的和親對象是個殘疾皇子赋续,可洞房花燭夜當晚...
    茶點故事閱讀 44,955評論 2 355

推薦閱讀更多精彩內容