盛天APP接口文档2

盛天APP接口文档V1.0刘骞20160321V1.1hn增加目录20160321说明：程序webservice的返回json格式遵守以下约定，{message:”返回消息信息”//返回的消息文本信息status：1//返回的状态值：0表示失败，1表示成功。model：{}或[]//返回的业务数据，可能是一个对象，也可能是一个数组。具体按照每个接约定做。}以下为方便理解，返回值略过message和status说明。目录说明： 1返回一个文章列表 1返回一个车牌列表 2登录手机号-密码 2请求手机验证码 3手机号注册 4获取周边停车场列表 4返回车牌列表 6返回用户信息 7修改头像 8解除绑定车牌 9反馈投诉 9计算停车费用 10获得计费策略 11获取文章列表方法名：getArticles//获取文章列表参数列表：city//如常州pageNow//当前页如获取第一个即1pageSize//每页数量：如10返回值说明model:返回一个文章列表例子：<soapenv:Envelopexmlns:soapenv="/soap/envelope/"xmlns:web="/"><soapenv:Header/><soapenv:Body><web:getArticles><city>常州</city><pageNow>1</pageNow><pageSize>10</pageSize></web:getArticles></soapenv:Body></soapenv:Envelope>{

"message":"获取文章列表成功",

"model":[

{

"author":"admin",

"city":"常州",

"content":"afdsafadsfa",

"createTime":1456477329000,

"id":7,

"title":"fadfdas"

},

{

"author":"admin",

"city":"常州",

"content":"fadafdsad",

"createTime":1456477337000,

"id":8,

"title":"22"

}

],

"status":1

}返回一个车牌列表方法名：getCarList参数列表：token//用户每登录一次，会生成一个token，客户端可以拿这个token去请求跟该用户相关的用户数据，一下不在详述。返回值说明model:返回一个车牌列表例子：登录手机号-密码方法名：login参数列表：mobile//手机号。password://密码返回值说明model//用户信息，参考st_customer表例子：<soapenv:Envelopexmlns:soapenv="/soap/envelope/"xmlns:web="/"><soapenv:Header/><soapenv:Body><web:login><mobile>lt;/mobile><password>111111</password></web:login></soapenv:Body></soapenv:Envelope>{

"message":"登录成功",

"model":{

"avatar":"/clientUpload/avatar/b464f81a-c8d3-419b-adad-a308530b89f4.jpg",

"id":1,

"locked":1,

"ly_table":"st_customer",

"mobile":,

"name":"刘骞123",

"sex":"女",

"token":"337dd3d5-c572-4a49-a2a5-0169e81327e5"

},

"status":1

}请求手机验证码方法名：requestSms//请求验证码参数列表：mobile//手机号返回值说明无返回值例子：<soapenv:Envelopexmlns:soapenv="/soap/envelope/"xmlns:web="/"><soapenv:Header/><soapenv:Body><web:requestSms><mobile>lt;/mobile></web:requestSms></soapenv:Body></soapenv:Envelope>{

"message":"发送验证码成功",

"status":1

}手机号注册方法名：regist//注册参数列表：mobile//手机号password//密码code//验证码：测试的是:1234返回值说明无返回值例子<soapenv:Envelopexmlns:soapenv="/soap/envelope/"xmlns:web="/"><soapenv:Header/><soapenv:Body><web:regist><mobile>lt;/mobile><password>111111</password><code>1234</code></web:regist></soapenv:Body></soapenv:Envelope>{

"message":"注册成功",

"status":1

}获取周边停车场列表方法名：getRoundBerth//获取周边停车场参数列表：latitude//纬度longitude//经度range//周边范围：公里返回值说明model//停车场列表例子<soapenv:Envelopexmlns:soapenv="/soap/envelope/"xmlns:web="/"><soapenv:Header/><soapenv:Body><web:getRoundBerth><latitude>119</latitude><longitude>31</longitude><range>100</range></web:getRoundBerth></soapenv:Body></soapenv:Envelope>{

"message":"获取信息成功",

"model":[

{

"area":"常州市武进区",

"busyBerth":0,

"createTime":1457523274000,

"id":3,

"latitude":31.774732,

"longitude":119.995251,

"name":"九龙大厦",

"no":"1002",

"remark":"空车位",

"road":"米新中路",

"strategyId":1,

"sumBerth":0

},

{

"area":"常州市武进区",

"busyBerth":0,

"createTime":1457523267000,

"id":2,

"latitude":31.75439,

"longitude":119.959416,

"name":"东方花园",

"no":"1002",

"remark":"全日制停车位",

"road":"东方花园",

"strategyId":1,

"sumBerth":0

},

{

"area":"常州市武进区",

"busyBerth":0,

"createTime":1457523260000,

"id":1,

"latitude":31.676267,

"longitude":119.955546,

"name":"湖塘停车场",

"no":"1002",

"remark":"空车位",

"road":"米新中路",

"strategyId":1,

"sumBerth":3

}

],

"status":1

}新增或者修改车牌号方法名：savePlateNum//新增或修改车牌号参数列表：token//登录标识plateId//车牌Id：如果是新增车牌就填空“”，否则就是修改该车牌号plateNum//车牌号：如苏D00000返回值说明model//车(辆)牌列表例子<soapenv:Envelopexmlns:soapenv="/soap/envelope/"xmlns:web="/"><soapenv:Header/><soapenv:Body><web:savePlateNum><token>89837243-1a6f-4770-8e5e-ce03761a20e6</token><plateId></plateId><plateNum>苏D0000</plateNum></web:savePlateNum></soapenv:Body></soapenv:Envelope>{

"message":"获取车牌信息成功",

"model":[

{

"customerId":4,

"id":10,

"plateNum":"苏D0000"

}

],

"status":1

}修改用户信息方法名：modifyUserInfo//修改用户信息参数列表：token//登录标识name//昵称sex//性别返回值说明model//用户信息例子<soapenv:Envelopexmlns:soapenv="/soap/envelope/"xmlns:web="/"><soapenv:Header/><soapenv:Body><web:modifyUserInfo><token>89837243-1a6f-4770-8e5e-ce03761a20e6</token><name>张三</name><sex>30</sex></web:modifyUserInfo></soapenv:Body></soapenv:Envelope>{

"message":"修改用户信息成功",

"model":{

"id":4,

"locked":1,

"ly_table":"st_customer",

"mobile":,

"name":"张三",

"password":"111111",

"sex":"30",

"token":"89837243-1a6f-4770-8e5e-ce03761a20e6"

},

"status":1

}修改头像方法名：modifyUserAvatar//修改头像参数列表：token//登录标识avatar//用户头像，格式：base64字符串，建议将图片压缩后上传返回值说明model//用户信息例子<soapenv:Envelopexmlns:soapenv="/soap/envelope/"xmlns:web="/"><soapenv:Header/><soapenv:Body><web:modifyUserAvatar><token>89837243-1a6f-4770-8e5e-ce03761a20e6</token><avatar></avatar>//文本太长，此处略</web:modifyUserAvatar></soapenv:Body></soapenv:Envelope>{

"message":"上传头像成功",

"model":{

"avatar":"/clientUpload/avatar/a2b3b78b-20b4-4e15-a53c-55e1debf7337.jpg",

"id":4,

"locked":1,

"ly_table":"st_customer",

"mobile":,

"name":"张三",

"password":"111111",

"sex":"30",

"token":"89837243-1a6f-4770-8e5e-ce03761a20e6"

},

"status":1

}解除绑定车牌方法名：removeCar//解除绑定车牌参数列表：token//登录标识carId//车牌ID返回值说明model//用户信息例子<soapenv:Envelopexmlns:soapenv="/soap/envelope/"xmlns:web="/"><soapenv:Header/><soapenv:Body><web:removeCar><token>89837243-1a6f-4770-8e5e-ce03761a20e6</token><carId>4</carId></web:removeCar></soapenv:Body></soapenv:Envelope>{

"message":"成功解除绑定",

"model":[

{

"customerId":4,

"id":10,

"plateNum":"苏D0000"

}

],

"status":1

}反馈投诉方法名：feedback//反馈投诉参数列表：mobile//手机号content//投诉内容返回值说明model//用户信息例子<soapenv:Envelopexmlns:soapenv="/soap/envelope/"xmlns:web="/"><soapenv:Header/><soapenv:Body><web:feedback><mobile>lt;/mobile><content>我看看</content></web:feedback></soapenv:Body></soapenv:Envelope>{

"message":"投诉成功,谢谢您!",

"status":1

}计算停车费用方法名：calStopFee//计算停车费用参数列表：parkId//停车场IDstopTime//停车时间（分钟）返回值说明model//费用（元）例子<soapenv:Envelopexmlns:soapenv="/soap/envelope/"xmlns:web="/"><soapenv:Header/><soapenv:Body><web:calStopFee><parkId>1</parkId><stopTime>100</stopTime></web:calStopFee></soapenv:Body></soapenv:Envelope>{

"message":"计算成功",

"model":17,

"status":1

}获得计费策略方法名：getChargeStrategy//获取计费策略参数列表：parkId//停车场ID返回值说明model//计费策略：包括计费规则列表和计费时间段列表例子<soapenv:Envelopexmlns:soapenv="/soap/envelope/"xmlns:web="/"><soapenv:Header/><soapenv:Body><web:getChargeStrategy><parkId>1</parkId></web:getChargeStrategy></soapenv:Body></soapenv:Envelope>{

"message":"获取计费策略成功",

"model":{

"chargeRule":[

{

"amount":3,

"createTime":1457523125000,

"id":4,

"maxTime":30,

"minTime":0,

"strategyId":1

},

{

"amount":6,

"createTime":1457523150000,

"id":5,

"maxTime":180,