架构设计--用户端全http參数接口具体说明v1

Posted clnchanpin

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了架构设计--用户端全http參数接口具体说明v1相关的知识,希望对你有一定的参考价值。

 

 

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)

username‘

 

`user_passwd`

varchar(50)

用户password‘

 

`user_question`

varchar(255)

password找回问题‘

 

`user_answer`

varchar(255)

password找回答案‘

 

`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)

password找回码‘

 

`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

 

返回数据:: 

假设有具体信息返回,登陆成功,数据结构同注冊。。

假设无具体信息返回,说明password错误

如有异常,返回异常。

 

 

数据字段

类型

说明

 

`user_id`

int(10)

用户id‘

 

`user_email`

varchar(100)

用户email‘

 

`user_name`

varchar(50)

username‘

 

`user_passwd`

varchar(50)

用户password‘

 

`user_question`

varchar(255)

password找回问题‘

 

`user_answer`

varchar(255)

password找回答案‘

 

`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)

password找回码‘

 

`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)

keyword‘

 

 

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

 

具体字段数据结构::

同上。商品有关的信息同商品结构表

 

以上是关于架构设计--用户端全http參数接口具体说明v1的主要内容,如果未能解决你的问题,请参考以下文章

API接口设计之tokentimestampsign 具体架构与实现(APP/小程序,传输安全)

Java电商平台 - API 接口设计之 tokentimestampsign 具体架构与实现

架构设计笔记_18_关键模式_监控体系

atitit.基于http json api 接口设计 最佳实践 总结o7

Docker 命令行和后台參数

「产品前端架构」接口设计