1. 程式人生 > >架構設計--使用者端全http引數介面詳細說明v1

架構設計--使用者端全http引數介面詳細說明v1

分享一下我老師大神的人工智慧教程!零基礎,通俗易懂!http://blog.csdn.net/jiangjunshow

也歡迎大家轉載本篇文章。分享知識,造福人民,實現我們中華民族偉大復興!

               

 

 

1. 使用者端全http引數介面詳細說明v1.doc 1

2. change histor 1

3. 介面通用引數說明 1

4. 函式註冊介面(規劃中) 3

5. 使用者許可權模組 3

5.1. 使用者註冊介面(增加使用者登陸資料) 3

5.2. 登陸介面(查詢使用者登陸許可權資料介面) 4

6. 使用者資訊模組 5

6.1. 修改使用者資訊 5

7. 商品模組 5

7.1. 呼叫範例 5

7.2. 顯示與查詢商品列表介面 6

7.3. 顯示商品詳情(顯示一條商品資料) 7

8. 訂單模組介面 7

8.1. 新增訂單資料 7

8.2. 查詢訂單資料(

多條與單條) 9

 

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://localhost:8080/shopitfs/api_http.jsp?method=regNormalUser&$user_name=aaaa&$user_passwd=hhh&datatype=mall_users&op=add

 

 

 

通用http引數說明()

引數

說明

取值範例

引數值說明

op

操作動作

query,search,select,catch,poll 為查詢操作

add/insert/create/reg新增,註冊操作

 

modify,update,edit為更新修改編輯資料操作

del,delete,remove為刪除移除資料操作

datatype

資料型別

xxxxx

要操作的資料物件

$field
(以美元符號開頭的內部資料欄位)

要新增或者更新的欄位。只限於updateadd操作使用

$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為鎖定'

 

 

 

 

 

 

呼叫範例

http://localhost:8080/shopitfs/api_http.jsp?method=regNormalUser&$user_name=aaaa&$user_passwd=hhh&datatype=mall_users&op=add

 

呼叫範例(引數sql格式:略)

呼叫範例(xx格式:略)

 

返回資料:: 一般返回空,如果有返回,資料結構同註冊。。如有異常,返回異常資訊

 

 

5.2. 登陸介面(查詢使用者登陸許可權資料介面)

 

呼叫方法   login4NormalUser

資料型別 :  同註冊介面

 

詳細欄位資料結構::同註冊介面

 

呼叫範例

http://localhost:8080/shopitfs/api_http.jsp?method=serachUserP3&@user_name=aaaa&@user_passwd=hhh&datatype=mall_users&op=query

 

返回資料:: 

如果有詳細資訊返回,登陸成功,資料結構同註冊。。

如果無詳細資訊返回,說明密碼錯誤

如有異常,返回異常。。

 

 

資料欄位

型別

說明

 

`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 就可

 

詳細欄位資料結構::

同上。商品有關的資訊同商品結構表

 

           

給我老師的人工智慧教程打call!http://blog.csdn.net/jiangjunshow

這裡寫圖片描述