下单通知接口

说明:合作伙伴将用户订单信息同步到开放平台,订单详情:如衣服数量、价格等。衣物备注和订单详请关联
请求方式:POST
接口访问路径:
                     沙箱地址:https://sandboxapi.daojia.com/api/{version}/h5/order/saveOrder
                     正式地址:http://openapi.daojia.com/api/{version}/h5/order/saveOrder
version说明:当前接口版本号(如v1)

系统级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • accessToken
  • String
  • 64256A615F66CC8FBE38AFCFD26EA744
  • 令牌校验,通过58到家提供的serviceKey和serviceSecret获得
  • serviceKey
  • String
  • 2801209652
  • 合作伙伴服务类型,由58到家分配,值唯一
  • sign
  • String
  • 见示例1
  • 调用API时需要对请求参数进行签名验证,到家服务器也会对该请求参数进行验证是否合法的。
  • format
  • String
  • json
  • 请求接口格式,暂只支持json.
  • timestamp
  • String
  • 2016-01-10 10:00:00
  • 时间戳,格式为yyyy-MM-ddHH:mm:ss,时区为GMT+8.到家服务端允许客户端请求最大时间误差为10分钟。
  • daojiaJson
  • Json
  • 见示例
  • 请求接口的应用级参数(Json格式).

应用级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • thirdOrderId
  • String
  • 12345
  • 合作伙伴订单ID
  • loginMobile
  • String
  • 15611111111
  • 登录账号手机号通过2.1.1解密phone获得
  • userMobile
  • String
  • 15888888888
  • 用户手机号
  • userName
  • String
  • 15888888888
  • 用户姓名
  • serviceBeginTime
  • String
  • "2016-01-10 10:30:00"
  • 预约开始服务时间
  • serviceEndTime
  • String
  • "2016-01-10 12:30:00"
  • 预约服务结束时间
  • serviceDuration
  • Float
  • 2.0
  • 服务时长(小时)
  • serviceAddress
  • String
  • "北美国际商务中心K2座"
  • 服务地址
  • cityId
  • Int
  • 1
  • 城市
  • cityName
  • String
  • 北京
  • 城市名称
  • lng
  • String
  • 116.433402
  • 经度
  • lat
  • String
  • 40.0121889
  • 纬度
  • deliveryType
  • Int
  • 1
  • 配送类型 1配送 2自提
  • deliveryPrice
  • Double
  • 0.0
  • 配送费
  • payType
  • Int
  • 1
  • 支付方式1:支付宝 2:微信 3:现金 4.代金券 5.其他
  • payStatus
  • Int
  • 1
  • 支付状态 0 未支付 1已支付 2 已退款
  • totalPrice
  • Double
  • 0。0
  • 订单总价
  • discountPrice
  • Double
  • 0。0
  • 订单优惠金额
  • params
  • String
  • ""
  • 订单扩展字段,json格式
  • remark
  • String
  • ""
  • 订单备注
  • createTime
  • String
  • "2016-01-10 10:00:00"
  • 订单创建时间
  • serviceCode
  • Int
  • 详见服务项编码列表,如果不在这个列表,则单独同到家接口人申请。
  • 服务项编码

示例:

{
"accessToken":"64256A615F66CC8FBE38AFCFD26EA744",
"serviceKey":"2801209652",
"sign":"7F0C70A269E9BE381581117A5D175D6A",
"format":"json",
 "timestamp":"2016-01-10 10:00:00",
        "daojiaJson":{
         "thirdOrderId":"12345",
         "loginMoble":"15611111111",
         "userMobile":"15888888888"
         "userName":"张三 ",
         "serviceBeginTime":"2016-01-10 10:30:00",
         "serviceEndTime":"2016-01-10 12:30:00",
         "serviceDuration":2.0,
         "serviceAddress":"北美国际商务中心K2座",
         "cityId":1,
         "cityName":"北京",
         "lng":"116.433402",
         "lat":"40.0121889",
         "deliveryType":1,
         "deliveryPrice":"9.9",
         "payType":1,
         "payStatus":1,
         "totalPrice":15.0,
         "discountPrice":0.0,
         "params":"",
         "remark":"",
         "createTime":"2016-01-10 10:00:00",
         "serviceCode":"1001"
        }
}


返回参数

  • 参数名
  • 类型
  • 示例
  • 描述
  • message
  • String
  • 成功
  • 调用接口返回的信息
  • code
  • Int
  • 0
  • 调用接口结果代码,0成功,1失败
  • data
  • Object
  • {}
  • 调用接口返回参数(json对象)

示例:

{
        "code":"0",
        "message":"同步成功",
        "data":{"orderId": 31421593368511488}
}

示例1--sign:
"7F0C70A269E9BE381581117A5D175D6A" 根据参数名称(除签名)将所有请求参数按照字母先后顺序排序:key + value .... key + value,例如:将foo=1,bar=2,baz=3 排序为bar=2,baz=3,foo=1,参数名和参数值链接后,得到拼装字符串bar2baz3foo1 将serviceSecret 拼接到参数字符串头、尾进行md5加密后,再转化成大写,格式是:byte2hex(md5(serviceSecretkey1value1key2value2...serviceSecret)) 注:byte2hex为自定义方法,JAVA中MD5是对字节数组加密,加密结果是16字节,我们需要的是32位的大写字符串

感谢您完成信息认证,
现在可以直接去创建应用啦!

创建应用

©2015 Daojia.com 58到家版权所有 津ICP备15004920号