open api 服务项目相关接口
一、搜索服务项目
1. 请求地址
环境 | 请求方式 | 请求地址 |
---|---|---|
正式 | POST | http://www.daoway.cn/daoway/rest/openapi/product/filter |
测试 | POST | http://test.daoway.cn/daoway/rest/openapi/product/filter |
2. 请求参数说明
Content-Type:application/x-www-form-urlencoded;charset=UTF-8
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
channel | string | 是 | nuomi | 渠道号,由到位分配 |
text | string | 否 | 家政 | 查询关键字 |
city | string | 否 | 北京 | 城市 |
lat | double | 否 | 经度 | |
lng | double | 否 | 纬度 | |
tag | string | 否 | 洗衣 | 标签 |
category | string | 否 | 25 | 分类id |
start | int | 否 | 0 | 起始游标 |
size | int | 否 | 20 | 返回数量 |
sign | string | 是 | rsa签名,所有参数参与签名,详见rsa签名与验签 |
3. 返回说明
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
status | string | ok | ok或error |
msg | string | 返回信息 | |
data | object | 返回数据 |
4. 返回数据data说明
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
totalNum | int | 100 | 结果总数量 |
start | int | 0 | 起始游标 |
size | int | 20 | 当前页显示数量 |
items | array | 服务项目列表 |
5. 服务项目列表items说明
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
id | string | 29052 | 服务项目id |
storeId | string | 店铺id | |
storeName | string | 宜生到家 | 店铺名称 |
salesNum | int | 已售数量 | |
name | string | 芳香SPA | 服务项目名称 |
description | string | 服务项目说明 | |
picUrl | string | 图片地址 | |
price | double | 价格 | |
priceUnit | string | 单位 | |
tags | string | 标签 | |
originalPrice | double | 原价 | |
minBuyNum | int | 最少购买数量 | |
positiveCommentRate | string | 好评率 | |
fastestNotice | string | 最快上门时间说明 | |
inDistanceScope | boolean | 是否在服务范围内 | |
notice | string |
6. 返回示例
{
status: "ok",
data: {
totalNum: 7702,
start: 0,
size: 1,
items: [
{
id: "29502",
storeId: "800ff6443dd043b39c7f17ede21dfc9d",
storeTitle: "宜生到家",
salesNum: 386,
name: "芳香SPA",
description: "时长:90分钟 服务姿势:卧姿 适用介绍: 适用于工作繁忙...",
picUrl: "http://img.daoway.cn/img/2016/08/10/4087f66d-6bb1-4278-8306-49b4a4be1514_thumb.jpg",
price: 208,
priceUnit: "元/次",
tags: "油压/SPA,美体塑形",
originalPrice: 298,
minBuyNum: "1",
positiveCommentRate: "98%",
fastestNotice: null,
notice: "可选技师"
}
]
}
}
二、服务项目详情
1. 请求地址
环境 | 请求方式 | 请求地址 |
---|---|---|
正式 | POST | http://www.daoway.cn/daoway/rest/openapi/product/detail |
测试 | POST | http://test.daoway.cn/daoway/rest/openapi/product/detail |
2. 请求参数说明
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
channel | string | 是 | nuomi | 渠道号,由到位分配 |
id | string | 是 | 服务项目id | |
lat | double | 否 | 经度 | |
lng | double | 否 | 纬度 | |
city | string | 否 | 北京 | 城市 |
sign | string | 是 | rsa签名,所有参数参与签名,详见rsa签名与验签 |
3. 返回说明
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
status | string | ok | ok或error |
msg | string | 返回信息 | |
data | object | 返回数据 |
4. 返回数据data说明
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
productId | int | 2014052 | 服务项目id |
productName | string | 芳香SPA | 服务项目名称 |
price | double | 50 | 价格 |
originalPrice | double | 50 | 原价 |
unit | string | 元/次 | 单位 |
picUrl | double | 50 | 服务项目图片地址 |
description | string | 服务项目描述 | |
minBuyNum | int | 1 | 最少购买数量 |
maxBuyNum | int | 0 | 最多购买数量(0为不限制) |
salesNum | int | 15 | 已售数量 |
imgs | array | 服务说明图片地址 | |
store | object | 店铺信息 |
5. store说明
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
storeId | string | 店铺id | |
storeName | string | 宜生到家 | 店铺名称 |
description | string | 店铺描述 | |
orderingNotice | string | 下单须知 | |
openTime | string | 开店时间 | |
closeTime | string | 关店时间 | |
minBuyPrice | double | 起送价 | |
positiveCommentRate | string | 好评率 | |
orderTakingRate | string | 接单率 | |
inDistanceScope | boolean | 是否在服务范围内 | |
nextAppointTime | date | 最近可预约的时间 |
6. 返回示例
{
data: {
productId: 56611,
productName: "家庭保洁",
price: 30,
originalPrice: 50,
unit: "元/小时",
picUrl: "http://img.daoway.cn/img/2016/12/28/804b76df-df07-4eed-8cec-2593348f3784.jpg",
description: "服务内容: 家庭保洁服务,2小时起订。(云家政暂时不提供带保洁工具上门服务) 服务保障: 1.根据满意度提交评价。 2.清洁内容丰富,专注卫生死角。 3.价格透明,在规定服务时间内不现场加价。 4.服务标准化,品质可预见。 5.发现怠工,随即终止服务或出现服务质量问题,可致电云家政客服热线协助处理。 服务范围: (可以在购买时间内自由安排服务项目,超出服务范围的服务要求可以现场与工人沟通) 1.客餐厅:电视柜、茶几、桌面、门、餐桌、垃圾桶、沙发下、地面、卫生死角。 2.卧室和阳台:阳台扶手、开关、插座、及其他。 3.书房和储物间:桌面、书柜、垃圾桶、地面、卫生死角及其他。 4.厨房:抽油烟机表面、橱柜、洗菜池、台面、地面、垃圾桶及其他。 5.卫生间:洗漱台、沐浴房、马桶、垃圾桶、地面及其他。",
minBuyNum: 2,
maxBuyNum: 0,
salesNum: 25555,
imgs: [
{
img: "http://img.daoway.cn/img/price/2016/12/29/b05ce20a-1e6c-415d-beb2-e6fa92cfc9c3.jpg",
width: 750,
height: 750
},
{
img: "http://img.daoway.cn/img/price/2016/12/29/0e571314-c7a4-4631-b48e-8d8499da0aeb.jpg",
width: 750,
height: 747
},
{
img: "http://img.daoway.cn/img/price/2016/12/29/c97a0a36-d102-4138-8d10-bdcb8e923f37.jpg",
width: 750,
height: 750
},
{
img: "http://img.daoway.cn/img/price/2016/12/29/681e4b1a-5f9a-4a1c-998c-9d0e6260c3f4.jpg",
width: 750,
height: 750
},
{
img: "http://img.daoway.cn/img/price/2016/12/29/6a3f5e25-15c8-4c75-b53f-899b5607ce3d.jpg",
width: 750,
height: 750
},
{
img: "http://img.daoway.cn/img/price/2016/12/29/9df53680-7571-4ddb-9d21-991873c54662.jpg",
width: 750,
height: 750
},
{
img: "http://img.daoway.cn/img/price/2016/12/29/aae57a6f-6002-4922-8f57-dc236ca0e1f8.jpg",
width: 750,
height: 750
},
{
img: "http://img.daoway.cn/img/price/2016/12/29/c97e4922-ae9a-4809-a555-cca8abe04305.jpg",
width: 750,
height: 750
},
{
img: "http://img.daoway.cn/img/price/2016/12/29/05072f4a-61bc-4e60-b65e-201dc7810600.jpg",
width: 750,
height: 750
},
{
img: "http://img.daoway.cn/img/price/2016/12/29/0d1784a3-b42c-4208-917c-a1e2f82b9427.jpg",
width: 750,
height: 750
},
{
img: "http://img.daoway.cn/img/price/2016/12/29/d7fabfc2-f7ca-47da-8a53-8b90e0dd2b4e.jpg",
width: 750,
height: 238
}
],
store: {
storeId: "c8e42f7716124bd2ad23c95445002d88",
storeName: "云家政",
description: "云家政是家政服务在线预订平台。我们的目标是让每个家庭都能获得诚信、便捷、有保障的家政服务。云家政拥有国内最大的实名认证家庭服务员数据库,目前平台上有超过100000名专业服务人员;数百个家政服务商,遍布全国主要城市各个社区。 云家政倡导简单、轻松的生活方式。通过把分散的家政服务能力汇集和分配,让中国家庭获得诚信、便捷、有保障的家政服务,解决日常生活中的麻烦事,把更多时间留给自己和家人,提高生活品质。",
orderingNotice: "1.商家将在您下单后30分钟内确认接单; 2.订单确认后,修改订单或退款需提前2小时通知; 3.预约时间前2小时内退单将按30元/人扣取误工费; 4.如商家接单后爽约将全额退款并向您额外赔付30元; 5.为保障您的权益,所有费用请通过到位平台支付。",
openTime: "08:00",
closeTime: "20:00",
minBuyPrice: 0,
orderTakingRate: "95%",
positiveCommentRate: "87%",
orderTakingCount: 19600,
nextAppointTime: 1487914200000,
inDistanceScope: true
}
},
status: "ok"
}