@lina
2016-05-20T03:46:14.000000Z
字数 11255
阅读 342
易试驾
api
iOS
Android
wechat
【线上base url】http://api.51eshijia.com/api/v2/
【测试base url】http://api.51yishijia.com/api/v2
通用上传文件服务
请求URL
POST
/upload
请求参数
token
file
: 文件
响应
{
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:3
series: 'A6L',
seriesId:2
thumbnailImg: '/1.png',
powerType: 1,
detail:{
bigImgArray: ['/1.png','/2.png'],
marketPrice:49.0,
gear:'6档无极变速',
gearType:1,
emissionType:1,
emission:2.0T
carType: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
请求参数
token
avatar
: [string]图片urlnickname
: [string]用户昵称
响应
{
errorCode: 0,
data: {
'@用户信息'
}
}
请求URL
POST
/feedback
请求参数
token
content
: 反馈内容
响应
{
errorCode: 0,
data: {
}
}
请求URL
POST
user/share
请求参数
token
platform
: [int] 分享平台类型:
1:微博 2:朋友圈 3:微信好友 4:QQ- TODO
响应
{
errorCode: 0,
data: {
}
}
请求URL
POST
rule/point
请求参数
响应
{
errorCode: 0,
data: {
list: [
'@积分规则'
]
}
}
请求URL
POST
/orders
请求参数
token
status
: '@订单状态常量',传 0 则返回全部订单
传 1,2 请求合并状态(如:“已取消”+“已完成”)的订单
响应
{
errorCode: 0,
data: {
list: [
'@订单信息'
],
pageInfo: [
'@分页字段'
]
}
}
请求URL
POST
/order/detail
请求参数
token
orderId
: [int] 订单ID
响应
{
errorCode: 0,
data: {
'@订单信息'
}
}
请求URL
POST
order/status
请求参数
token
orderId
: [int] 订单IDstatus
:[int]要修改成结果的状态,取消订单传2 完成订单传3
响应
{
errorCode: 0,
data: {
id:123
}
}
id
: [int] 订单 ID
请求URL
POST
/order/comment
请求参数
token
orderId
: [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 | 试驾热榜 |