说明:开发一套新首页页面的接口数据,要求 接口路径不同往前,全新接口
数据:
启安本地服务器: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 的图片集合组成的页面