@lina
2016-05-20T03:46:14.000000Z
字数 11255
阅读 393
易试驾 api iOS Android wechat
【线上base url】http://api.51eshijia.com/api/v2/
【测试base url】http://api.51yishijia.com/api/v2
通用上传文件服务
请求URL
POST
/upload
请求参数
tokenfile: 文件
响应
{errorCode: 0,data: {url: 'http://xxx'}}
url: [string] 文件的访问URL
token: [string] 登录后获取的token信息
:时效为1年,过期提示“请重新登录”,弹出登录页面
errorCode: [int] 服务器状态码,0 为正常状态,异常状态待定。errorMessage:[string] 错误信息,但errorCode不为 0 时返回
data: [object] 数据字段,所有响应数据都在此字段中list: [array],当返回数据为列表时会将数据放在该字段
pageInfo: [object] 分页信息,当返回数组数据时会携带该字段
currentPage: [int] 当前页码totalPage: [int] 总页数pageSize: [int] 每页数量
示例
{errorCode: 0,data: {key: value,list: [{key: value}],pageInfo {}}}
powerType: [int] gearType: [int] emissionType: [int] carType: [int] priceSection: [int] emissionSection: [int] orderStatus: [int]
{lon: 142.32323232,lat: 39.232400123}
lon: [float] 经度lat: [float] 纬度
{addr: '理想国际大厦',fullAddr: '北京市海淀区理想国际大厦'coor: {'@坐标信息'}}
addr: [string] 起始地址fullAddr: [string] 起始地址全称coor: [object] 起始位置坐标
{id: 1,brand: '奥迪',logo: '/1.png'}
id: [int] 车品牌 IDbrand: [string] 名称logo: [string] 车标
{id: 1,series: 'A6L',price: 280,thumbnail:'/1.png'}
id: [int] 车系IDseries: [string] 车系price: [float] 车系价格thumbnail: [string] 车系图片
{id: 1,spec: '2012款 2.0t 520Li典雅型',modelName:'520Li典雅型',specId:111,brand: '奥迪',brandId:3series: 'A6L',seriesId:2thumbnailImg: '/1.png',powerType: 1,detail:{bigImgArray: ['/1.png','/2.png'],marketPrice:49.0,gear:'6档无极变速',gearType:1,emissionType:1,emission:2.0TcarType:1,size:'4500x1750x450',wheelBase:2610,quality:1290,engine:'1.8L 128马力 L4',year:2015,structure:'4门5座3箱车'}}
id: [int] 本条数据库IDspec: [string] 拼接车型名称,拼接规则:年份+排量+车型名称modelName: [string] 车型名称,例如:520Li典雅型specId: [int] 车型IDbrand: [string] 品牌名称series: [string] 车系名称thumbnailImg: [string] 车型列表图片,默认后台上传第一个图 图片比例 3:2 750*500powerType: [int] 1:汽油(默认) 2:电力 3:混合动力detail: [object]车型详细信息
bigImgArray: [array] 车型详情图片 图片比例:marketPrice: [float] 市场价格(万),展示到小数点后两位gear: [string] 变速箱名称gearType: [int] 1:自动 2:手动emissionType: [int] 1:其他 2:国四 3:国五emission:[string]排量例如2.0LcarType: [int] 1:紧凑型车 2:小型车 3:中型车size: [string] 汽车尺寸长宽高(mm)wheelBase: [float] 轴距(mm)quality: [float] 质量(kg)engine: [string] 发动机名称year:[int]车款年份 从2011~2015structure:[string]车身结构:4门5座3箱车
{id: 123,nickname: 'xiaobaitu',avatar: '/img1.imgtn.bdimg.com/it/u=1477579747,1739345058&fm=23&gp=0.jpg',cell: '15801379137',points: 1000}
id: [int] 用户IDnickname: [string] 用户昵称avatar: [string] 头像图片地址cell: [string] 用户手机号points: [int] 积分
{id: 1,reason: 1,points: 100,}
id: [int] 积分规则IDreason: [int] 1:分享增加(100) 2:评价增加(100) 3:订单完成增加(0)points: [int] 增加积分数
{id: 1,name: '百得利奥迪中心',addr: '北京市经济技术开发区东环北路1号1,coor: {'@坐标信息'},desc: '简介',tel: '010-83829389',contactor:'Hallen',cell:'13811849645',worktime:91000,closetime:99000,offdays:'1324232323,1324232324,1324232325',remark:'特殊说明'dis: 230,maxRange:15,routeImg:'/1.png',canPick:1}
id: [int] 4S店 IDname: [string] 4S店名称addr: [string] 地址coor: [object] 经纬度坐标
lon: [float] 经度lat: [float] 纬度dis: [float] 距离用户的距离,单位为米(请求时必须携带用户坐标)desc: [string] 简介tel: [string] 客服电话contactor: [string] 联系人cell: [string] 联系人手机worktime: [int]开始工作时间的时间戳,比如9:00,那就是60*60*9closetime: [int] 关门时间,给是为时间戳,相对今天0:0的秒数offdays: [string] 不工作时间戳,使用逗号分开,要从小到大顺序排列remark: [string] 特殊说明maxRange:[int]最大接送公里范围routeImg:[string]试驾路线图片canPick:[int]1:上门接送 0:不上门接送
{id: 1,user: '@用户信息',score: 5,content:'这次体验非常好,非常好非常好非常好非常好非常好非常好',time:14390009}
id: [int] 评论IDuser: [object] 用户信息content: [string] 评论内容score: [float] 评分time: [int] 评论时间,时间戳
{id: 1,title: '专业测评宝马5系',subtitle: '在赛道内进行了专业的测评,包括碰撞实验,加速实验',thumbnail:'/1.png'contentH5:'http://xxxxxx'relativeCar:'@车型'}
id: [int] 资讯IDtitle: [string] 标题subtitle: [string] 副标题thumbnail: [string] 缩略图contentH5: [string] 内容Html页面relativeCar: [object]相关车型
订单状态
- 1: 待服务
- 2: 已取消
- 3: 已完成
订单信息
{id: 1,sn: 201539430493,4S: {'@4S店信息'},car: {brand:'@车品牌',series:'@车系',spec:'@车型'},status: 1,date: {start: 1231321212,end: 12313213212},from: {'@地址'},comment: {date: 1429549593193,score: 4,isComment:0},price: 200,type: 1,createdDate: 1429549593193,cancelDate: 1429549593193,completeDate: 1429549593193}
id: [int] 订单IDsn: [string] 订单编号4S: [object] 4S 店信息,参考4S店信息(付费则没有4S)car: [object]status: [int] 订单状态
- 1: 待服务
- 2: 已取消
- 3: 已完成
date: [object] 订单时间段
start: [int] 时间段开始end: [int] 时间段结束from: [object] 试驾起始位置'@地址'comment: [object] 评论
date: [int] 评论日期score: [int] 评分isComment: [bool] 是否已评价createdDate: [int] 订单创建日期cancelDate: [int] 订单取消日期completeDate: [int] 订单完成日期type: [int] 订单类型,1 - 免费,2 - 收费
【线上base url】http://api.51eshijia.com/Api/V2/
【测试base url】
请求URL
POST
/login/verifycode
请求参数
phoneNumber: [string]接收验证码的手机号
响应
{errorCode: 0,data: {}}
请求URL
POST
/login
请求参数
phoneNumber: 手机号verifyCode: 验证码deviceId: 设备 ID
响应
{errorCode: 0,data: {token: '19201931210e'}}
token: [string] 登录成功后的token,后续数据接口均需携带该参数
请求URL
POST
/loginout
请求参数
token
响应
{errorCode: 0,data: {}}
请求URL
POST
/me
请求参数
token
响应
{errorCode: 0,data: {'@用户信息'}}
请求URL
POST
/me/update
请求参数
tokenavatar: [string]图片urlnickname: [string]用户昵称
响应
{errorCode: 0,data: {'@用户信息'}}
请求URL
POST
/feedback
请求参数
tokencontent: 反馈内容
响应
{errorCode: 0,data: {}}
请求URL
POST
user/share
请求参数
tokenplatform: [int] 分享平台类型:
1:微博 2:朋友圈 3:微信好友 4:QQ- TODO
响应
{errorCode: 0,data: {}}
请求URL
POST
rule/point
请求参数
响应
{errorCode: 0,data: {list: ['@积分规则']}}
请求URL
POST
/orders
请求参数
tokenstatus: '@订单状态常量',传 0 则返回全部订单
传 1,2 请求合并状态(如:“已取消”+“已完成”)的订单
响应
{errorCode: 0,data: {list: ['@订单信息'],pageInfo: ['@分页字段']}}
请求URL
POST
/order/detail
请求参数
tokenorderId: [int] 订单ID
响应
{errorCode: 0,data: {'@订单信息'}}
请求URL
POST
order/status
请求参数
tokenorderId: [int] 订单IDstatus:[int]要修改成结果的状态,取消订单传2 完成订单传3
响应
{errorCode: 0,data: {id:123}}
id: [int] 订单 ID
请求URL
POST
/order/comment
请求参数
tokenorderId: [int] 订单IDscore: [int] 评分content: [string] 评论内容
响应
{errorCode: 0,data: {}}
请求URL
POST
comments
请求参数
specId: [int] 车型 ID【必填】pageNum: [int]【必填】pageSize:[int]【必填】
响应
{errorCode: 0,data: {list: ['@评论'],pageInfo:['@分页字段']}}
请求URL
POST
/ad/banners
请求参数
无
响应
{errorCode: 0,data: {list: [{pic: 'https://ss0.bdstatic.com/70cFuHSh_Q1YnxGkpoWK1HF6hhy/it/u=1722966551,3293303547&fm=116&gp=0.jpg',link: '#abc',title: '试驾特斯拉Model S P85D',desc: '来自未来的车'}]}}
pic: [string] Banner 图片地址link: [string] 链接title: [string] 广告标题desc: [string] 广告描述
请求URL
POST
/car/brands
请求参数
cityName: [string] 所在城市名,默认北京【选填】
响应
{"errorCode": 0,"data": {"list": [{"letter": "A","detail": [{‘@车品牌’}]},{"letter": "B","detail": [{"id": 3,"logo": "http://img.autoimg.cn/logo/brand/50/130713021464992840.jpg","brand": "保时捷"}]}]}}
id: [int] 品牌IDletter: [string] 字母logo: [string] 品牌图片brand: [string] 品牌名称
请求URL
POST
/car/model
请求参数
brandId: [int] 品牌id 不传或者传0为‘全部品牌’【选填】priceSection: [int] '@汽车价格区间常量'【选填】gearType: [int] '@汽车变速箱类型常量'【选填】carType: [int] '@汽车车辆类型常量'【选填】emissionSection: [int] '@汽车排量常量'【选填】keyword:[string]搜索关键词,keyword和其他以上参数互斥【选填】检索品牌、车系、车型cityName: [string] 所在城市名,默认北京【选填】pageNum: [int]【必填】pageSize:[int]【必填】
响应
{errorCode: 0,data: {list: [car:{'@车型'},isFull:0,driveCount:200],pageInfo:['@分页字段']}}
isFull: [int] 是否预约满 0:未约满 1:约满driveCount: [int] 试驾累计人数,200起。。
请求URL
POST
/car/model/hot
请求参数
无
响应
{errorCode: 0,data: {list: [car:{'@车型'},isFull:0,driveCount:200],pageInfo:['@分页字段']}}
isFull: [int] 是否预约满 0:未约满 1:约满driveCount: [int] 试驾累计人数,200起。。
请求URL
POST
/car/brands/hot
请求参数
无
响应
{errorCode: 0,data: {list: ['@车品牌']}}
请求URL
POST
/score
请求参数
specId: [int] 车型 ID【必填】
响应
{errorCode: 0,data: {score:4.5}}
score: [float] 评分0~5
请求URL
POST
/car/model/detail
请求参数
specId: [int] 车型 ID【必填】
响应
{errorCode: 0,data: {car:{'@车型'},isFull:0,driveCount:200}}
isFull: [int] 是否预约满 0:未约满 1:约满driveCount: [int] 试驾累计人数,200起
请求URL
POST
/order/create
请求参数
token【必填】seriesId: [int] 车系 ID【必填】specId: [int] 车型 ID【必填】fromFullAddr: [string] 接送位置全名称【必填】fromAddr: [string] 接送位置名称【必填】fromLon: [float] 接送位置经度【必填】fromLat: [float] 接送位置纬度【必填】shopId: [int] 4S店 ID【必填】start: [int] 预约start时间戳【必填】
响应
响应
{errorCode: 0,data: {'@订单信息'}}
请求URL
POST
/shops
请求参数
cityName: [str] 所在城市名称,默认北京【选填】seriesId: [int] 车系 ID【必填】specId: [int] 车型 ID, 任意车型请传0或不传【必填】locationLon: [float] 当前位置经度,定位不到不传或者传0【选填】locationLat: [float] 当前位置纬度,定位不到不传或者传0【选填】addr: [string] 接送地址【选填】
{errorCode: 0,data: {list: ['@4S店信息']}}
请求URL
POST
/shops/times
请求参数
seriesId: [int] 车系 ID【必填】specId: [int] 车型 ID, 任意车型请传0或不传【必填】shopId: [int] 4S 店ID,【必填】
响应
{errorCode: 0,data: {list: [{date: 13434343343,day: [{start: 1324232323,end: 12313213212,available: 1}],}]}}
list 中对象的 key 为指定的日期(天),value 为当天的时间段
date: [int] 某一天的日期时间戳day: [object] 一天的时间段
start: [int] 预约起始时间end: [int] 预约结束时间avaiable: [int] 是否可预约 0 - 否,1 - 可
请求URL
POST
/news
请求参数无
响应
{errorCode: 0,data: {'@资讯'}}
请求URL
POST
/user/collects
请求参数
token:身份认证【必填】
响应
{errorCode: 0,data: {list: [car:{'@车型'},isFull:0,driveCount:200],pageInfo:['@分页字段']}}
请求URL
POST
/user/collect/change
请求参数
token:身份认证【必填】specId:车型id【必填】collected:1收藏 0取消收藏【必填】
响应
{errorCode: 0,data: {}}
请求URL
POST
/user/collect/check
请求参数
token:身份认证【必填】specId:车型id【必填】
响应
{errorCode: 0,data: {collected:0}}
collected:1收藏 0未收藏请求URL
POST
/push
请求参数
user_id: [string] 推送用户ID 必填channel_id: [string] 设备ID 必填token: [string] 用户标识 [选填]device_type: [int] 设备类型 1:iOS,2:andriod 必填
响应
{errorCode: 0,data: {}}
请求URL
POST
/push/channel
请求参数
user_id: [string] 推送用户ID 必填
响应
{errorCode: 0,data: {}}
aps:{alert:"test",badge:1,type:"1",orderId:12233,link:'http://xxxxxxx',title:'xxxxx'}
for android: title:固定:“易试驾” content:alert字段type: [string] 0:只唤起app,无二级页面 1:普通推送 2:订单推送orderId: [string]type == 2,看orderId,进入订单详情。link: [string]type == 1,link不为空进入H5页面。title: [string]type == 1,进入H5页面是topbar标题。H5 URL
H5 URL
H5 URL
H5 URL
1、车型分享地址:
【线上】http://m.51eshijia.com/product/+车型ID
【测试】http://m2.51eshijia.com/product/+车型ID
标题:我在易试驾发现一款超棒的车型,赶快来看看!
摘要:车好不好,试了才知道!预约试驾,首选易试驾!2、预约成功:http://www.51eshijia.com/app
标题:我通过易试驾平台成功预约到XXX试驾服务,定位推荐,一键预约果然方便!
摘要:试驾难?预约难?易试驾轻松搞定,更能优先试驾!
H5 URL
文案:
易试驾是北京车语互联科技有限公司旗下一款试驾预约APP,该产品秉承“让试驾变得更容易”的理念,通过线上预约,线下体验的方式,为买车换车用户提供购车前的试驾预约服务。
H5 URL
请求方式:
Get
请求参数
type: 1:正式版本 2:build版本 3: alpha版本
正式版本H5页面显示Version+版本号
build版本H5页面显示Build+版本号
alpha版本H5页面显示Alpha+版本号
type:版本种类【必填】versionNum:版本号【必填】
H5 URL
【测试地址】http://m2.51eshijia.com/home/guide?from=app
【线上地址】http://m.51eshijia.com/home/guide?from=app
【安卓市场】
| 描述 | from |
|---|---|
| 360手机助手 | Android_360 |
| 安卓市场 | Android_market |
| 豌豆荚 | Android_wandoujia |
| 百度手机助手 | Android_baidu |
| 应用宝 | Android_app |
| 小米商店 | Android_mi |
| 安智市场 | Android_anzhi |
| 乐商店 | Android_leshop |
| 华为应用市场 | Android_huawei |
| 魅族应用中心 | Android_meizu |
| oppp软件商店 | Android_oppp |
| UC | Android_uc |
| 友盟 | Android_umeng |
| 官网 | Android_officalwebsite |
【iOS苹果】
| 描述 | from |
|---|---|
| 苹果商店 | App Store |
| PP助手 | iOS_PP |
| 同步推 | iOS_tongbutui |
| 快用苹果助手 | iOS_kuaiyong |
| 苹果园 | iOS_pingguoyuan |
| 91助手iOS | iOS_91 |
| 官网 | iOS_officalwebsite |
| 事件( 统计点) | event_id | attribute | 英文名称 | 中文名称 |
|---|---|---|---|---|
| 点击首页”搜索“ | ESJ_0009(首页) | “platestr”=“home_search” | home_search | 首页搜索 |
| 点击首页”资讯“ | ESJ_0009(首页) | “platestr”=“home_news” | home_news | 首页资讯 |
| 点击首页”banner“ | ESJ_0009(首页) | “platestr”=“home_banner” | home_banner | 首页广告 |
| 点击首页”我要试驾“ | ESJ_0009(首页) | “platestr”=“home_brand” | home_brand | 首页品牌 |
| 点击首页“立即预约” | ESJ_0009(首页) | “platestr”=“home_order” | home_order | 首页预约 |
| 点击“车型列表进入详情” | ESJ_0014 | car_detail | 车辆详情 | |
| 点击“评价列表” | ESJ_0012 | comment_list | 评价列表 | |
| 点击“热榜” | ESJ_0013 | hot_list | 试驾热榜 |