添加商品信息

说明:合作伙伴通过该接口将商品信息添加到58到家开放平台,同一合作伙伴的同一服务类,商品ID不能重复。
请求方式:POST
接口访问路径:
                     沙箱地址:https://sandboxapi.daojia.com/api/{version}/goods/saveGoods
                     正式地址:http://openapi.daojia.com/api/{version}/goods/saveGoodse
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格式).

应用级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • goodsId
  • String
  • 1
  • 合作伙伴商品id
  • goodsTypeId
  • String
  • 2
  • 合作伙伴商品类别id
  • goodsName
  • String
  • "时尚男女皮包-中-30-40cm"
  • 商品名称
  • goodsUnit
  • String
  • 商品单位
  • goodsDisplay
  • String
  • "洗护+保养+免费收送"
  • 商品显示内容
  • goodsDuration
  • String
  • "预计4天"
  • 服务耗时
  • goodsPic
  • String
  • ""
  • 商品图片地址
  • goodsStatus
  • Int
  • "预计4天"
  • 商品状态,1可用,0不可用
  • createTime
  • String
  • "2015-01-01 12:00:00"
  • 创建时间

示例:

{
        "accessToken":"64256A615F66CC8FBE38AFCFD26EA744",
        "serviceKey":"2801209652",
        "format":"json",
        "timestamp":"2016-01-10 10:00:00",
        "sign":"7F0C70A269E9BE381581117A5D175D6A",
        "daojiaJson":{
         "goodsId":" 1 ",
         "goodsTypeId":"2"
         "goodsName":" 时尚男女皮包-中-30-40cm ",
         "goodsUnit":" 件 ",
         "goodsDisplay":" 洗护+保养+免费收送 ",
         "goodsDuration":" 预计4天 ",
         "goodsPic":" ./image/1.jpg ",
         "goodsStatus":" 1 ",
         "createTime":" 2015-01-01 12:00:00 ",
        }
}


返回参数

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

示例:

{
        "code":"0",
        "message":"商品增加成功!",
        "data":{}
}

更新商品信息

说明:合作伙伴的商品信息发生变化时,调用此接口,将商品信息更新。(目前不存在删除接口,status字段代表是否可用,如果删除,就把status字段更新成0)
请求方式:POST
接口访问路径:
                     沙箱地址:https://sandboxapi.daojia.com/api/{version}/goods/updateGoods
                     正式地址:http://openapi.daojia.com/api/{version}/goods/updateGoods

系统级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • 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格式).

应用级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • goodsId
  • String
  • 1
  • 合作伙伴商品id
  • goodsTypeId
  • String
  • 2
  • 合作伙伴商品类别id
  • goodsName
  • String
  • "时尚男女皮包-中-30-40cm"
  • 商品名称
  • goodsUnit
  • String
  • 商品单位
  • goodsDisplay
  • String
  • "洗护+保养+免费收送"
  • 商品显示内容
  • goodsDuration
  • String
  • "预计4天"
  • 服务耗时
  • goodsPic
  • String
  • ""
  • 商品图片地址
  • goodsStatus
  • Int
  • "预计4天"
  • 商品状态,1可用,0不可用
  • updateTime
  • String
  • "2015-01-01 12:00:00"
  • 更新时间

示例:

{
        "accessToken":"64256A615F66CC8FBE38AFCFD26EA744",
        "serviceKey":"2801209652",
        "format":"json",
        "timestamp":"2016-01-10 10:00:00",
        "sign":"7F0C70A269E9BE381581117A5D175D6A",
        "daojiaJson":{
         "goodsId":" 1 ",
         "goodsTypeId":"2"
         "goodsName":" 时尚男女皮包-中-30-40cm ",
         "goodsUnit":" 件 ",
         "goodsDisplay":" 洗护+保养+免费收送 ",
         "goodsDuration":" 预计4天 ",
         "goodsPic":" ./image/1.jpg ",
         "goodsStatus":" 1 ",
         "updateTime":" 2015-01-01 12:00:00 ",
        }
}


返回参数

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

示例:

{
        "code":"0",
        "message":"商品更新成功!",
        "data":{}
}

查询单个商品信息

说明:合作伙伴可以调用此接口,查询在58到家存储的某个类别下的某个商品信息
请求方式:POST
接口访问路径:
                     沙箱地址:https://sandboxapi.daojia.com/api/{version}/goods/getGoods
                     正式地址:http://openapi.daojia.com/api/{version}/goods/getGoods

系统级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • 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格式).

应用级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • goodsId
  • String
  • 1
  • 合作伙伴商品id

示例:

{
        "accessToken":"64256A615F66CC8FBE38AFCFD26EA744",
        "serviceKey":"2801209652",
        "format":"json",
        "timestamp":"2016-01-10 10:00:00",
        "sign":"7F0C70A269E9BE381581117A5D175D6A",
        "daojiaJson":{
         "goodsId":" 1 ",
        }
}


返回参数

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

示例:

{
        "code":"0",
        "message":"查询商品类别成功!",
        "data":{
         "goodsId":" 1 ",
         "goodsTypeId":"2"
         "goodsName":" 时尚男女皮包-中-30-40cm ",
         "goodsUnit":" 件 ",
         "goodsDisplay":" 洗护+保养+免费收送 ",
         "goodsDuration":" 预计4天 ",
         "goodsPic":" ./image/1.jpg ",
         "goodsStatus":" 1 ",
         "createTime":" 2015-01-01 12:00:00 ",
        }
}


示例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号