前言

最近在學習深度學習，已經跑出了幾個模型，但Pyhton的基礎不夠扎實，因此，開始補習Python了，大家都推薦廖雪峰的課程，因此，開始了學習，但光學有沒有用，還要和大家討論一下，因此，寫下這些帖子，廖雪峰的課程連接在這里：廖雪峰
Python的相關介紹，以及它的歷史故事和運行機制，可以參見這篇：python介紹
Python的安裝可以參見這篇：Python安裝
Python的運行模式以及輸入輸出可以參見這篇：Python IO
Python的基礎概念介紹，可以參見這篇：Python 基礎
Python字符串和編碼的介紹，可以參見這篇：Python字符串與編碼
Python基本數據結構：list和tuple介紹，可以參見這篇：Python list和tuple
Python控制語句介紹：ifelse，可以參見這篇：Python 條件判斷
Python控制語句介紹：循環實現，可以參見這篇：Python循環語句
Python數據結構：dict和set介紹Python數據結構dict和set
Python函數相關：Python函數
Python高階特性：Python高級特性
Python高階函數：Python高階函數
Python匿名函數：Python匿名函數
Python裝飾器：Python裝飾器
Python偏函數：Python偏函數
Python模塊：Python模塊
Python面向對象編程（1）：Python面向對象
Python面向對象編程（2）：Python面向對象（2）
Python面向對象編程（3）：Python面向對象（3）
Python面向對象編程（4）：Pyhton面向對象（4）
Python面向對象高級編程（上）：Python面向對象高級編程（上）
Python面向對象高級編程（中上）：Python面向對象高級編程（中上）
Python面向對象高級編程（中下）：Python面向對象高級編程（中下）
Python面向對象高級編程（完）：Python面向對象高級編程（完）
Python錯誤調試（起）：Python調試：起
Python錯誤調試（承）：Python調試：承
Python錯誤調試（轉）：Python調試：轉
Python錯誤調試（合）：python調試：合
Python文件IO編程：Python文件IO
Python文件IO編程2：Python文件IO2
Python文件IO編程3：PYthon文件IO3
Python進程和線程（起）：Python進程和線程起
Python進程和線程（承）：Python進程和線程承
Python進程和線程（轉）：Python進程和線程轉
Python進程和線程（合）：Python進程和線程合
Python正則表達式：Python正則表達式
Python學習筆記:常用內建模塊1：Python學習筆記：常用內建模塊1
Python學習筆記:常用內建模塊2：Python學習筆記：常用內建模塊2
Python學習筆記:常用內建模塊3：Python學習筆記：常用內建模塊3
Python學習筆記:常用內建模塊4：Python學習筆記: 常用內建模塊4
Python學習筆記:常用內建模塊5：Python學習筆記: 常用內建模塊5
Python學習筆記:常用內建模塊6:Python學習筆記：常用內建模塊6
Python學習筆記:第三方模塊1：Python常用第三方模塊
Python學習筆記:第三方模塊2：Python常用第三方模塊
Python學習筆記:第三方模塊3：Python常用第三方模塊
Pytho學習筆記：網絡編程：Python網絡編程
Python學習筆記：電子郵件：Python電子郵件1
Python學習筆記：SMTP服務器：PythonSMTP服務器
Python學習筆記：POP3服務器：PythonPOP3服務器
Python學習筆記：Python數據庫 Python數據庫1
Python學習筆記：Python數據庫2Python數據庫2
Python學習筆記：web開發1Python學習筆記：web開發1
Python學習筆記：web開發2Python學習筆記: web開發2
Python學習筆記: web開發3Python學習筆記: web開發3
Python學習筆記：異步IO（1）Python學習筆記：異步IO（1）
Python學習筆記：異步IO（2）Python學習筆記：異步IO（2）
Python學習筆記：異步IO（3）Python學習筆記：異步IO（3）
Python學習筆記：Day 1-2開發Python學習筆記：Day1-2開發
Python學習筆記：Day 3 ORMPython學習筆記：Day3 ORM
Python學習筆記：Day 4 ModelPython學習筆記：Day4Model
Python學習筆記：Day 5 web框架PYTHON學習筆記：DAy5
Python學習筆記：Day 6 配置文件Python學習筆記：Day 6 配置文件
Python學習筆記：Day 7 編寫MVCPython學習筆記：Day 7編寫MVC
Python學習筆記：Day 8 構建前端Python學習筆記:Day 8 構建前端

目錄

• 前言
• 目錄
• 編寫API
  • 什么是Web API呢？

編寫API

自從Roy Fielding博士在2000年他的博士論文中提出REST（Representational State Transfer）風格的軟件架構模式后，REST就基本上迅速取代了復雜而笨重的SOAP，成為Web API的標準了。

什么是Web API呢？

如果我們想要獲取一篇Blog，輸入http://localhost:9000/blog/123，就可以看到id為123的Blog頁面，但這個結果是HTML頁面，它同時混合包含了Blog的數據和Blog的展示兩個部分。對于用戶來說，閱讀起來沒有問題，但是，如果機器讀取，就很難從HTML中解析出Blog的數據。

如果一個URL返回的不是HTML，而是機器能直接解析的數據，這個URL就可以看成是一個Web API。比如，讀取http://localhost:9000/api/blogs/123，如果能直接返回Blog的數據，那么機器就可以直接讀取。

REST就是一種設計API的模式。最常用的數據格式是JSON。由于JSON能直接被JavaScript讀取，所以，以JSON格式編寫的REST風格的API具有簡單、易讀、易用的特點。

編寫API有什么好處呢？由于API就是把Web App的功能全部封裝了，所以，通過API操作數據，可以極大地把前端和后端的代碼隔離，使得后端代碼易于測試，前端代碼編寫更簡單。

一個API也是一個URL的處理函數，我們希望能直接通過一個@api來把函數變成JSON格式的REST API，這樣，獲取注冊用戶可以用一個API實現如下：

@get('/api/users') def api_get_users(*, page='1'):page_index = get_page_index(page)num = yield from User.findNumber('count(id)')p = Page(num, page_index)if num == 0:return dict(page=p, users=())users = yield from User.findAll(orderBy='created_at desc', limit=(p.offset, p.limit))for u in users:u.passwd = '******'return dict(page=p, users=users)

只要返回一個dict，后續的response這個middleware就可以把結果序列化為JSON并返回。

我們需要對Error進行處理，因此定義一個APIError，這種Error是指API調用時發生了邏輯錯誤（比如用戶不存在），其他的Error視為Bug，返回的錯誤代碼為internalerror。

客戶端調用API時，必須通過錯誤代碼來區分API調用是否成功。錯誤代碼是用來告訴調用者出錯的原因。很多API用一個整數表示錯誤碼，這種方式很難維護錯誤碼，客戶端拿到錯誤碼還需要查表得知錯誤信息。更好的方式是用字符串表示錯誤代碼，不需要看文檔也能猜到錯誤原因。

可以在瀏覽器直接測試API，例如，輸入http://localhost:9000/api/users，就可以看到返回的JSON：

總結

以上是生活随笔為你收集整理的Python学习笔记：Day 9 编写API的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。