架構設計--使用者端全http引數介面詳細說明v1
分享一下我老師大神的人工智慧教程!零基礎,通俗易懂!http://blog.csdn.net/jiangjunshow
也歡迎大家轉載本篇文章。分享知識,造福人民,實現我們中華民族偉大復興!
1. 使用者端全http引數介面詳細說明v1.doc
2. change histor
p3t v1
作者:: 老哇的爪子 Attilax 艾龍, EMAIL:[email protected]
轉載請註明來源: http://blog.csdn.net/attilax
3. 介面通用引數說明
介面地址 http://localhost:8080/shopitfs/api_http.jsp
介面測試工具:: 瀏覽器直接測試。無需工具
呼叫範例 (註冊使用者)
通用http引數說明()
引數 |
說明 |
取值範例 |
引數值說明 |
op |
操作動作 |
query,search,select,catch,poll 為查詢操作 add/insert/create/reg為新增,註冊操作
|
modify,update,edit為更新修改編輯資料操作 del,delete,remove為刪除移除資料操作 |
datatype |
資料型別 |
xxxxx |
要操作的資料物件 |
$field |
要新增或者更新的欄位。只限於update、add操作使用 |
$user_name=aaaa |
|
condition |
條件 |
name='aaa'
Name like like '%迪%'
|
支援>,<,=等操作符。 支援and,or 邏輯操作符連線多個條件 單引號作為字串分界符 模糊查詢為 like '%%' 格式 整個條件表示式語法與sql相容 。 |
@field (以猴頭符號開頭的條件表示式欄位) |
表明條件欄位。。只能表達簡單and條件。如需其他複雜查詢,使用condition欄位。當此引數與conditon引數都有的時候,conditon引數優先使用 |
@user_name=aaaa |
多個欄位直接只能and 條件。如需其他複雜查詢,使用condition欄位 |
order |
排序欄位 |
Id
id desc a desc,b asc |
資料的排序 支援asc,desc排序。 支援多欄位排序,多欄位用逗號分隔。語法與sql一致 |
|
|
|
|
page |
翻頁引數 |
1,10 |
1表示第一頁,10表示pagesize |
返回資料::基本全部為json格式
多個數據物件的連線複合查詢(規劃中)::
自定義函式的使用::
預設引數全部支援mysql5資料庫的預設函式。。。如果要使用自定義函式,可以通過函式註冊介面註冊自定義函式
注:為了方便使用,許多功能儘可能的相容sql語法,方便查詢文件資料
4. 函式註冊介面(規劃中)
方法名: regFunction
引數:: 函式體
5. 使用者許可權模組
5.1. 使用者註冊介面(增加使用者登陸資料)
呼叫方法 regNormalUser
資料型別 : mall_users
詳細欄位資料結構
資料欄位 |
型別 |
說明 |
|
`user_id` |
int(10) |
使用者id' |
|
`user_email` |
varchar(100) |
使用者email' |
|
`user_name` |
varchar(50) |
使用者名稱' |
|
`user_passwd` |
varchar(50) |
使用者密碼' |
|
`user_question` |
varchar(255) |
密碼找回問題' |
|
`user_answer` |
varchar(255) |
密碼找回答案' |
|
`user_ico` |
varchar(255) |
'使用者頭像' |
|
`reg_time` |
datetime |
註冊時間' |
|
`last_login_time` |
datetime |
最後登陸時間' |
|
`last_ip` |
char(15) |
最後登陸ip' |
|
`email_check` |
tinyint(1) |
郵件確認' |
|
`email_check_code` |
varchar(255) |
郵件確認碼' |
|
`forgot_check_code` |
varchar(255) |
密碼找回碼' |
|
`rank_id` |
int(10) |
使用者級別' |
|
`locked` |
tinyint(1) |
使用者鎖定,1為鎖定' |
|
|
|
|
|
呼叫範例
呼叫範例(引數sql格式:略)
呼叫範例(xx格式:略)
返回資料:: 一般返回空,如果有返回,資料結構同註冊。。如有異常,返回異常資訊
5.2. 登陸介面(查詢使用者登陸許可權資料介面)
呼叫方法 login4NormalUser
資料型別 : 同註冊介面
詳細欄位資料結構::同註冊介面
呼叫範例
返回資料::
如果有詳細資訊返回,登陸成功,資料結構同註冊。。
如果無詳細資訊返回,說明密碼錯誤
如有異常,返回異常。。
資料欄位 |
型別 |
說明 |
|
`user_id` |
int(10) |
使用者id' |
|
`user_email` |
varchar(100) |
使用者email' |
|
`user_name` |
varchar(50) |
使用者名稱' |
|
`user_passwd` |
varchar(50) |
使用者密碼' |
|
`user_question` |
varchar(255) |
密碼找回問題' |
|
`user_answer` |
varchar(255) |
密碼找回答案' |
|
`user_ico` |
varchar(255) |
'使用者頭像' |
|
`reg_time` |
datetime |
註冊時間' |
|
`last_login_time` |
datetime |
最後登陸時間' |
|
`last_ip` |
char(15) |
最後登陸ip' |
|
`email_check` |
tinyint(1) |
郵件確認' |
|
`email_check_code` |
varchar(255) |
郵件確認碼' |
|
`forgot_check_code` |
varchar(255) |
密碼找回碼' |
|
`rank_id` |
int(10) |
使用者級別' |
|
`locked` |
tinyint(1) |
使用者鎖定,1為鎖定' |
|
|
|
|
|
6. 使用者資訊模組
6.1. 修改使用者資訊
呼叫方法 modifyUserinfo
資料型別 : mall_user_info
詳細欄位資料結構::
`id` |
int(10) |
|
`user_id` |
int(10) |
使用者id' |
`user_truename` |
varchar(255) |
真實姓名' |
`user_ico` |
varchar(255) |
使用者頭像' |
`user_marry` |
tinyint(1) |
0保密,1未婚,2已婚' |
`user_gender` |
tinyint(1) |
0保密,1男,2女' |
`user_mobile` |
varchar(20) |
使用者手機號' |
`user_telphone` |
varchar(20) |
使用者電話' |
`user_country` |
smallint(6) |
國家' |
`user_province` |
smallint(6) |
省份' |
`user_city` |
smallint(6) |
城市' |
`user_district` |
smallint(6) |
區' |
`user_zipcode` |
char(6) |
使用者郵編' |
`user_address` |
varchar(255) |
使用者地址' |
`user_birthday` |
date |
使用者生日' |
`user_qq` |
varchar(16) |
使用者qq' |
`user_msn` |
varchar(50) |
使用者msn' |
`user_skype` |
varchar(50) |
使用者skype' |
呼叫範例: 參考以上模組
返回資料:: 如有異常,返回異常。。
7. 商品模組
7.1. 呼叫範例
如上
7.2. 顯示與查詢商品列表介面
呼叫方法 searchGoods
操作資料型別:: mall_goods
資料欄位 |
型別 |
說明 |
|
|
`goods_id` |
int(10) |
商品id |
|
|
`shop_id` |
int(10) |
店鋪id' |
|
|
`goods_name` |
varchar(255) |
商品名稱' |
|
|
`cat_id` |
int(10) |
分類id' |
|
|
`ucat_id` |
int(10) |
使用者自定義分類id' |
|
|
`brand_id` |
int(10) |
品牌id' |
|
|
`type_id` |
int(10) |
屬性型別id' |
|
|
`goods_intro` |
text |
商品詳情' |
|
|
`goods_wholesale` |
text |
批發說明' |
|
|
`goods_number` |
int(5) |
庫存量' |
|
|
`goods_price` |
decimal(82) |
商品價格' |
|
|
`transport_price` |
decimal(82) |
運費' |
|
|
`keyword` |
varchar(255) |
關鍵字' |
|
|
`is_delete` |
tinyint(1) |
0為已刪除' |
|
|
`is_best` |
tinyint(1) |
1為精品' |
|
|
`is_new` |
tinyint(1) |
1為新品' |
|
|
`is_hot` |
tinyint(1) |
1為熱銷' |
|
|
`is_promote` |
tinyint(1) |
1為特價' |
|
|
`is_admin_promote` |
tinyint(1) |
|
|
|
`is_on_sale` |
tinyint(1) |
0為下架,1為上架' |
|
|
`is_set_image` |
tinyint(1) |
是否已設定圖片' |
|
|
`goods_thumb` |
varchar(255) |
縮圖' |
|
|
`pv` |
int(10) |
關注度' |
|
|
`favpv` |
int(10) |
被收藏次數' |
|
|
`sort_order` |
tinyint(1) |
排序' |
|
|
`add_time` |
datetime |
新增時間' |
|
|
`last_update_time` |
datetime |
最後修改時間' |
|
|
`lock_flg` |
tinyint(1) |
鎖定,1為鎖定' |
|
|
`is_transport_template` |
tinyint(1) |
是否啟用郵費模版' |
|
|
`transport_template_id` |
int(11) |
郵費模版id' |
|
|
`transport_template_price` |
float(50) |
認默模板運費' |
|
|
返回資料::
如果有資料,結構同上。。
如有異常,返回異常。。
7.3. 顯示商品詳情(顯示一條商品資料)
呼叫方法 searchGoods
操作資料型別:: mall_goods
提交與返回的資料基本同搜尋商品。。只需要設定條件類似 goods_id=1 就可。。。
8. 訂單模組介面
8.1. 新增訂單資料
呼叫方法 addOrderP29
資料型別 : orderinfoVirt
範例
詳細欄位資料結構::
`order_id` |
int(10) |
訂單id' |
|
|
`payid` |
varchar(20) |
支付訂單號' |
|
|
`shop_id` |
int(10) |
店鋪id' |
|
|
`pay_id` |
int(10) |
支付方式id' |
|
|
`pay_name` |
varchar(255) |
支會方式名稱' |
|
|
`user_id` |
int(10) |
使用者id' |
|
|
`transport_price` |
decimal(6 |
運費' |
|
|
`order_value` |
float |
訂單應付金額' |
|
|
`order_amount` |
decimal(10 |
總訂單價格' |
|
|
`consignee` |
varchar(50) |
聯絡人' |
|
|
`country` |
smallint(6) |
0' |
COMMENT |
國家' |
`province` |
smallint(6) |
省份' |
|
|
`city` |
smallint(6) |
城市' |
|
|
`district` |
smallint(6) |
地區' |
|
|
`address` |
varchar(255) |
' |
COMMENT |
詳細地址' |
`zipcode` |
char(6) |
郵政編碼' |
|
|
`telphone` |
varchar(20) |
電話' |
|
|
`mobile` |
varchar(20) |
手機' |
|
|
`email` |
varchar(255) |
郵箱' |
|
|
`shipping_name` |
varchar(50) |
物流公司名稱' |
|
|
`shipping_no` |
varchar(50) |
物流發貨單號' |
|
|
`shipping_type` |
varchar(50) |
發貨運輸型別' |
|
|
`message` |
text |
COMMENT |
訂單附言' |
|
`order_time` |
datetime |
訂單時間' |
|
|
`pay_time` |
datetime |
支付時間' |
|
|
`shipping_time` |
datetime |
發貨時間' |
|
|
`receive_time` |
datetime |
使用者已接收時間' |
|
|
`order_status` |
tinyint(1) |
訂單狀態:0已取消訂單,1使用者已下訂單,2商家已確認訂單,3使用者驗貨' |
|
|
`pay_status` |
tinyint(1) |
支付狀態:0未支付,1已支付' |
|
|
`transport_status` |
tinyint(1) |
發貨狀態:0未發貨,1已發貨' |
|
|
`protect_status` |
tinyint(1) |
0' |
COMMENT |
維權狀態 |
`trade_no` |
varchar(50) |
支付寶返回的,支付寶交易號' |
|
|
`seller_reply` |
tinyint(1) |
買家是否回覆:0未回覆,1回覆' |
|
|
`buyer_reply` |
tinyint(1) |
賣家是否回覆:0未回覆,1回覆' |
|
|
`group_id` |
int(10) |
團購id' |
|
|
`pay_message` |
text |
COMMENT |
支付留言' |
|
`complaint` |
tinyint(1) |
使用者投訴' |
|
|
`get_back_time` |
datetime |
申請退款時間' |
|
|
`transport_type` |
int(11) |
運輸型別1Ems |
2平郵,3快遞' |
|
`order_actual` |
decimal(10 |
COMMENT |
實付金額' |
|
返回資料:: 無
如有異常,返回異常。。
8.2. 查詢訂單資料(多條與單條)
呼叫方法 queryOrderData
資料型別 : order_goods_v
單條資料設定條件類似 order_id=1 就可
詳細欄位資料結構::
同上。商品有關的資訊同商品結構表