一公司的移动端API接口设计，欢迎评论

最新推荐文章于 2024-01-27 14:02:16 发布

anjqy

最新推荐文章于 2024-01-27 14:02:16 发布

阅读量1.5k

点赞数

文章标签：问题吐槽

本文链接：https://blog.csdn.net/anjqy/article/details/79485287

版权

一个团队移动端API设计接口，欢迎广大移动端开发小伙伴的建议。

下面举例说明

获取产品列表

接口路径
/v1/xxxxx/lists

接口参数

参数名	类型	默认值	必填项	备注
custom_id	int	0	NO	供应商id(获取所有sku时传：-1，不传为获取当前登录客户的)
pid	int	0	NO	上级id
keywords	string	NULL	NO	关键词（sku名称/平台码/本地货号）
goods_id	string	NULL	NO	产品id
seller_id	string	NULL	NO	供应商客户id
status	int	0	NO	状态（0：下架，1：上架）不传为获取所有
is_self	int	0	NO	产品类型（ 1：自营，0：非自营）不传为获取所有
catid	int	0	NO	分类id
attrs	array	NULL	NO	关联信息(stocks：库存信息)
relations	array	NULL	NO	关联信息(parent：上级sku信息、被克隆的产品信息，custom：供应商信息，goods：产品信息，prices：价格信息，category：品类信息，brand：品牌信息，district：源产地信息)
price	Boole	fasle	NO	是否获取价格信息（ true：是，fasle：否）
order	string	id DESC	NO	排序(选填)
limit	int	12	NO	查询条数
page	int	fasle	NO	查询页码

页面需求：列表每项显示里面产品基本信息，10个字段左右

现实设计：json数据：{

"code": 200,
"message": "success",
"result": [
{
"skuid":17,
"type":0,
"pid":9,
"goods_id":12,
"brand_id":13,
"catid":46,
"district_id":0,
"custom_id":3,
"seller_id":2,
"skuname":"新疆阿克苏冰糖心苹果 12个经典70-80号礼盒装总重 ",
"sn":"N18030610055174198",
"localsn":"",
"unit":0,
"spec":"1.9kg/箱",
"weight":"0.00",
"min_number":1,
"method":0,
"quote":"1.00",
"supply_scale":0,
"sale_price":"0.00",
"stock_num":"0.00",
"img":"",
"desc":null,
"status":1,
"create_time":"2018-03-06 10:05:51",
"update_time":"2018-03-06 10:05:51",
"delete_time":null,
"sync_time":0,
"stocks":{
"skusn":"N18030610055174198",
"custom_id":3,
"sale_stock":"0.00",
"total_stock":"10.00",
"virtual_stock":"0.00",
"available_stock":"10.00",
"transport_stock":"0.00",
"order_stock":"0.00",
"lock_stock":"0.00",
"safe_stock":"0.00",
"presell_stock":"0.00"
},
"category":{
"id":46,
"pid":17,
"name":"烟富",
"keywords":"烟富",
"description":"烟富",
"level":4,
"sort":0,
"status":1,
"create_time":"2018-03-01 16:17:30",
"update_time":"2018-03-01 16:17:30",
"delete_time":null,
"status_text":"已通过"
},
"brand":{
"id":13,
"name":"苹果",
"descript":"鲜甜可口",
"catid":0,
"logo":"http://api.3gys.cn/uploads/20180304/common/3d0866bace6874e04011dc4f2951fba94ae8afcf.jpg",
"licence":"http://api.3gys.cn/uploads/20180303/common/9b5304fa537e28a034308d14204f606a06681ff3.jpg",
"custom_id":3,
"sort":1,
"status":1,
"create_time":"2018-03-04 15:03:50",
"update_time":"2018-03-04 15:03:50",
"delete_time":null,
"status_text":"已通过"
},
"district":{
"id":652901,
"parent_id":652900,
"name":"阿克苏市",
"merger_name":"中国,新疆维吾尔自治区,阿克苏地区,阿克苏市",
"short_name":"阿克苏",
"merger_short_name":"中国,新疆,阿克苏,阿克苏",
"level_type":"3",
"city_code":"0997",
"zip_code":"843000",
"pinyin":"Akesu",
"jianpin":"AKS",
"first_char":"A",
"lng":"80.26338",
"lat":"41.16754",
"remarks":"",
"createtime":null,
"updatetime":null,
"delete_time":null
},
"prices":[
{
"id":19,
"goods_id":12,
"skuid":17,
"custom_id":3,
"seller_id":2,
"cluster_id":0,
"quoted_price":"1.00",
"price_history":null,
"min":1,
"method":0,
"sort":0,
"create_time":"2018-03-06 10:05:51",
"update_time":"2018-03-06 10:05:51",
"delete_time":null,
"cluster":null,
"method_text":"现付"
}
],
"status_text":"上架",
"unit_text":"",
"method_text":"现付"
},
{...}]