统一接口说明和要点

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

数据:

启安本地服务器:10.60.1.226 

测试稳定服务器:10.60.1.150:8081 

测试账号:101087327 123456

表A - 统一接口说明

 编号作用  原接口 新接口 请求参数 返回参数
 1 首页接口  chomePage/cListWithPublish  chomePage/cGetBody ~ 看以下说明
 2 模块【更多】进入 ~ homePage/cGetMoreByHomePageType hpType int型 是homepage的type字段 必传 看一下说明


反参说明:

编号1接口:

返回的结果是homePage的对象集合,以下是每个homePage对象的属性:

imgUrl是头部图片信息; 

type是homePage的类型( 1首页轮播  6麦缌美学馆 7美肌研究所 8美肤秘笈 9当日优选 10当月品牌) 这里给出了这次用到的类型;

carouselList是轮播图集合,每个carousel轮播图都有关键的imageUrl,和跳转地址(跳转地址看特别说明);

moreFlag是【更多】按钮是否出现的标识,t出现f不出现。 


编号2接口:

接口2是摸个模块点击【更多】按钮进去的内容,传的是homePage的type字段,必传,返回结果是carousel的集合,也需要注意特别说明。


特别说明:

carousel 和 homePage 两个对象都有相关的跳转地址,具体分为两大类,一类是url(地址)一类是detailsPageImgs(详情页),其中url可再细分相对路径和绝对路径(是否含http),那么前端跳转的优先级是  url>detailsPageImgs  ,解释来说:当这个对象有url,用户点击跳url地址(分绝对和相对),其次看detailsPageImgs 详情页,是跳转到一个由detailsPageImgs里的图片集合构成的页面。




@黄华超

关于carousel对象点击跳转的优先级和跳转方式实现,推荐全局方法使用:

优先级(先做非空判断):url>videoUrl>detailsPageImgs      [url>视频>详情页]

实现方式:

url:其中url可再细分相对路径和绝对路径(是否含http)支持外部链接跳转

videoUrl :点击跳转视频播放页面 

detailsPageImgs  :跳转一个由detailsPageImgs 的图片集合组成的页面