網路應用程式,分為前端和後端兩個部分。當前的發展趨勢,就是前端裝置層出不窮(手機、平板、桌面電腦、其他專用裝置......)。因此,必須有一種統一的機制,方便不同的前端裝置與後端進行通訊。這導致api構架的流行,甚至出現"apifirst"的設計思想。restful api是目前比較成熟的一套網際網路應用程式的api設計理論。
rest(representational state transfer)表述性狀態轉換,rest指的是一組架構約束條件和原則。 如果乙個架構符合rest的約束條件和原則,我們就稱它為restful架構。rest本身並沒有創造新的技術、元件或服務,而隱藏在restful背後的理念就是使用web的現有特徵和能力, 更好地使用現有web標準中的一些準則和約束。雖然rest本身受web技術的影響很深, 但是理論上rest架構風格並不是繫結在http上,只不過目前http是唯一與rest相關的例項。
1)url格式:
這裡,代表api的版本資訊。是乙個你可以用來定義任何技術的區域(例如:安全-允許指定的使用者可以訪問這個區域。)或者業務上的區域(例如:同樣的功能在同乙個字首之下。)。 代表這個域(domain)下,約定的rest介面集合。
2)引數格式:
get採用兩種常見格式
②路徑引數,如:
post採用兩種常見格式
①json格式包裝引數提交
post
②form表單引數提交
post
title=test&sub%5b%5d=1&sub%5b%5d=2&sub%5b%5d=33)返回體格式:
"status」: 200,
"message」:"使用者查詢返回成功」,
「document」:」
"data」: }
1)restful api依託paas平台治理,需要對api進行認證、授權、引數加密等操作,可考慮在http頭部加認證token、呼叫鏈指令、狀態資訊等系列資訊。
2)如ppt所言,api分層,會有內部api和外部api之分,兩種api的設計或有不同(甚至是不同協議)。
3)對於api設計的狀態選擇,建議為無狀態、n次冪等,但後續或存在效能優化問題,http2.0待評測。
出處:
微服務RESTful 介面設計規範
網路應用程式,分為前端和後端兩個部分。當前的發展趨勢,就是前端裝置層出不窮 手機 平板 桌面電腦 其他專用裝置.因此,必須有一種統一的機制,方便不同的前端裝置與後端進行通訊。這導致api構架的流行,甚至出現 apifirst 的設計思想。restful api是目前比較成熟的一套網際網路應用程式的a...
Restful介面設計
rest是英文representational state transfer 表象性狀態轉變 或者表述性狀態轉移 rest是web服務的一種架構風格 使用http,uri,xml,json,html等廣泛流行的標準和協議 輕量級,跨平台,跨語言的架構設計 它是一種設計風格,不是一種標準,是一種思想 ...
RESTFUL介面設計規範
rest 是representational state transfer的縮寫,意思是表述性狀態轉移,我個人理解就是資源資料的變化。api與使用者的通訊協議,總是使用https協議。協議網域名稱 應該盡量將api部署在專用網域名稱之下。如果確定api很簡單,不會有進一步擴充套件,可以考慮放在主網域...