通用接口, 得有 必定的 格式好比:數據庫
請求參數說明:例如 {appKey:123,userToken:」xx」,v:1.0,jsonString:」xx」,sign:」123」}json
jsonStringapp
返回值 類型JSON設計
JSON內容指針 |
說明接口 |
||
result開發 |
0 int 系統異常字符串 2 令牌失效string
|
||
message產品 |
狀態說明信息 (String) |
||
data |
key |
類型 |
說明 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
開發接口的過程當中, 不要相信,產品,不要 相信 數據庫表 設計者,都淚啊。儘可能作到 nullpoint 空指針的異常判斷,就算沒有數據,也儘可能 返回 空字符串給 app.或者是 有默認值,不要這樣子來:好比
data |
key |
類型 |
說明 |
|
total |
int |
消息總數 |
|
|
total 大於0纔有下面 |
|
|
messages |
json |
Key: 下面是值 |
|
msgId |
int |
主鍵 |
|
title |
string |
標題 |
|
time |
string |
時間 |
|
content |
Sting |
消息內容 |
不要這樣,好比 total >0 下面纔有 ,數據,這樣 對之後 寫 dto 或者是 vo ,都很差啊,應該是 一個 bean的類型,並且 對於 app端的 封裝 接收數據什麼的 都是很不方便的