说明:开发一套新商城页面的接口数据,要求 接口路径不同往前,全新接口
数据:
启安本地服务器:10.60.1.226
测试稳定服务器:10.60.1.150:8081
测试账号:101087327 123456
表A - 统一接口说明
| 编号 | 作用 | 原接口 | 新接口 | 请求参数 | 返回参数 |
|---|---|---|---|---|---|
| 1 | 商城顶部轮播 | cCarousel/cList | cMall/cGetTop | ~ | 原 cCarousel/cList返回数据格式 |
| 2 | 商城搜索 | cProduct/cQuery | ~ | 参考以前 | 参考以前 |
| 3 | 产品标签分类 | ~ |
cMall/ | ~ | 看反参说明 |
| 4 | 获取主体 | ~ |
cMall/ | ~ | 看反参说明 |
| 5 | 获取每个标签的产品 | ~ |
cMall/ | tagId int型必传 | 看反参说明 |
| 6 | 获取活动标签的产品 | ~ |
cMall/ | psName String型 必传 是活动标签的名字 | 看反参说明 |
反参说明:
编号1的返回结果为原来的接口数据一样,是carousel集合,可以参考以前。
编号2参考以前
编号3是获取产品有效的标签和活动,返回的结果是一个map,key为tag是tag的集合,每个tag都有相关的id,imageUrl,name;key为activity为carousel的集合,同往常的轮播图一样有图片,url和详情页。
编号4是获取主体信息,返回结果为一个map。
标号6返回的是product的集合。
sales-今日必抢
---
sales第二版改版数据格式说明:
原products伪null,分成3类,前段依次排版discountProducts(原products内容) +groupProducts(拼团产品) +seckillProducts(限时秒杀) ,
后面的这三个分别是product集合(产品集合),拼团产品集合(每个对象的groupValidSize为x人团的参数,buyNumber为已拼x人),秒杀产品集合(每个对象的结束时间 endDate 为毫秒值时间戳),这些对象的属性是有区别的,展示页面的discountProducts和以前的products一样,拼团产品和秒杀产品排版需要参照设计图,字段意义可以参照以前的模块设计来给到。
---
news-新品上市
pureEssential-精油三部曲
summerSunscreen-夏季防晒
recommend-当季推荐
essential-必备单品
每个值都是productStatus对象,topImg 是头图片信息,carousels是内容图集合, products为产品列表,其中今日必抢的产品标签需要自己打上去,后台不传数据。moreFlag是【更多】按钮是否出现的标识,t出现f不出现。
编号5获取每个标签的产品,tagId必传(是tag的id),返回参数一个map,其中tagName是标签名,productRecommendList是推荐产品,内含产品分类和产品集合,可以参考以前的cProduct/cGetRecommendList接口
特别说明:
carousel 跳转地址,具体分为两大类,一类是url(地址)一类是detailsPageImgs(详情页),其中url可再细分相对路径和绝对路径(是否含http),那么前端跳转的优先级是 url>detailsPageImgs ,解释来说:当这个对象有url,用户点击跳url地址(分绝对和相对),其次看detailsPageImgs 详情页,是跳转到一个由detailsPageImgs里的图片集合构成的页面。