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"
}