【正文】 和直觀。舉例：/cars 而不是 /car/users 而不是 /user/products 而不是 /product/settings 而不是 /setting使用子資源表達(dá)關(guān)系。下面是一些常見(jiàn)的參數(shù)。? 406 Not Acceptable [GET]：用戶請(qǐng)求的格式不可得（比如用戶請(qǐng)求JSON格式，但是只有XML格式）。通過(guò)Swagger進(jìn)行REST API的正確定義，用戶可以理解遠(yuǎn)程服務(wù)并使用最少實(shí)現(xiàn)邏輯與遠(yuǎn)程服務(wù)進(jìn)行交互。注：Microsoft,PayPal等公司也已經(jīng)引入Swagger 來(lái)定義自己的REST API 文檔。? 422 Unprocesable entity [POST/PUT/PATCH]：當(dāng)創(chuàng)建一個(gè)對(duì)象時(shí)，發(fā)生一個(gè)驗(yàn)證錯(cuò)誤。? ?pageNumber=2amp。舉例：GET /cars/911/drivers/ 返回 car 911的所有司機(jī)GET /cars/911/drivers/8 返回 car 911的8號(hào)司機(jī)HTTP動(dòng)詞(HTTP Verbs)對(duì)于資源的具體操作類型，由HTTP動(dòng)詞表示。注：需要注意版本規(guī)劃，以便以后API的升級(jí)和維護(hù)。從客戶端到服務(wù)器的每個(gè)請(qǐng)求都必須包含理解請(qǐng)求所必需的信息。要獲取這個(gè)資源，需要訪問(wèn)它的URI，因此，URI就成了每一個(gè)資源的地址或獨(dú)一無(wú)二的識(shí)別符。在RESTful架構(gòu)中，每個(gè)URL代表一種資源（resource），所以網(wǎng)址中不能有動(dòng)詞，只能有名詞，而且所用的名詞往往與代表的對(duì)象名稱對(duì)應(yīng)。? PUT（UPDATE）：在服務(wù)器更新資源（客戶端提供改變后的完整資源）。order=asc：指定返回結(jié)果按照哪個(gè)屬性排序，以及排序順序。盡量使用詳細(xì)的錯(cuò)誤包裝信息：{ errors: [ { userMessage: Sorry, the requested resource does not exist, internalMessage: No car found in the database, code: 4xx, more info: } ]}返回結(jié)果（Response）服務(wù)器返回的數(shù)據(jù)格式，應(yīng)該盡量使用JSON，避免使用XML。附Swagger文件示例：{ swagger: , info: { version: , title: Swagger Petstore (Simple), description: A sample API that uses a petstore as an example to demonstrate features in the specification, termsOfService: , contact: { name: Swagger API team, foo, url: }, license: { name: MIT, url: } }, host: , basePath: /api, schemes: [ ], consumes: [ application/json ], produces: [ application/json ], paths: { /pets: { get: { description: Returns all pets from the system that the user has access to, operationId: findPets, produces: [ application/json, application/xml, text/xml, text/html ], parameters: [ { name: tags, in: query, description: tags to filter by, required: false, type: array, items: { type: string }, collectionFormat: