统一接口说明

说明:开发一套新商城页面的接口数据,要求 接口路径不同往前,全新接口

数据:

启安本地服务器:10.60.1.226 

测试稳定服务器:10.60.1.150:8081 

测试账号:101087327 123456

表A - 统一接口说明

 编号作用  原接口 新接口 请求参数 返回参数
 1商城顶部轮播   cCarousel/cList  cMall/cGetTop ~ 原 cCarousel/cList返回数据格式
 2商城搜索  cProduct/cQuery ~ 参考以前 参考以前
 3 产品标签分类 ~  cMall/cGetTagAndActivity ~ 看反参说明
 4 获取主体 ~  cMall/cGetBody ~ 看反参说明
 5获取每个标签的产品 ~  cMall/cGetProductsByTag tagId int型必传 看反参说明
 6 获取活动标签的产品 ~  cMall/cGetProductsByProductStatusName 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里的图片集合构成的页面。