## 微商城API文檔

### 1. 背景

本文旨在為實(shí)現(xiàn)微團(tuán)手機(jī)客戶端與服務(wù)端提供統(tǒng)一的接口調(diào)用與交互規(guī)范。

### 2. 規(guī)范適用對(duì)象說明

1. 產(chǎn)品經(jīng)理

2. 項(xiàng)目經(jīng)理

3. 程序員

### 3. 名詞解釋

* restful：REST (REpresentational State Transfer) 描述了一個(gè)架構(gòu)樣式的網(wǎng)絡(luò)系統(tǒng)，比如 web?應(yīng)用程序。指的是一組架構(gòu)約束條件和原則。滿足這些約束條件和原則的應(yīng)用程序或設(shè)計(jì)就是 RESTful。

* json：JSON(JavaScript Object Notation) 是一種輕量級(jí)的數(shù)據(jù)交換格式。它基于JavaScript（Standard ECMA-262 3rd Edition - December 1999）的一個(gè)子集。 JSON采用完全獨(dú)立于語(yǔ)言的文本格式，但是也使用了類似于C語(yǔ)言家族的習(xí)慣（包括C, C++, C#, Java, JavaScript, Perl, Python等）。

### 4. 請(qǐng)求數(shù)據(jù)包格式規(guī)范

API提供如下REST風(fēng)格的HTTP接口：

http://hostname/hello/world?fields=appdata

query_string由系統(tǒng)級(jí)參數(shù)部分和具體API調(diào)用參數(shù)部分組成，以key1=value&key2=value2&…表示.。

### 5.響應(yīng)數(shù)據(jù)包格式規(guī)范

響應(yīng)數(shù)據(jù)包的格式為json格式，編碼為UTF-8。

http響應(yīng)頭中的Content-Type指定為application/json, charset=utf-8