千牛和集成方http接口协议

更新时间:2015/12/09 访问次数:11969

介绍

  • 为了更好的提高客服接待效率,客服端(千牛)会在合适的时机调用集成方的http服务,获取用户信息,宝贝焦点等等数据。
  • 以如下界面为例,客服端(千牛)的官方足迹插件会访问开发者服务器,以获取宝贝详细信息,供客服查看。
    image
  • 您可以查看足迹定制用户定制 加强对于该服务的了解。
  • 此文提供统一的调用接口协议。

TOP开发者后台

  • 开发者可以在后台填入统一http服务的url,并且勾选支持的服务类别,客服端(千牛)会根据开发者支持的服务进行调用。
  • data_secret由开发者填入,开发者可以通过如下的方法校验请求的合法性。

image

http服务接口协议

以填入的url为http://www.taobao.com/openim为例(url中不要包含?)
客服端(千牛)采用post的形式进行访问,请求url为http://www.taobao.com/openim,post数据为method=…&ts=…&q=…&s=…

参数说明:

参数名 参数含义 备注
method 服务名 例如getprofile,getitemdetail,具体见业务服务文档
ts 当前访问时间unix time 开发者如果发现请求时间和当前时间差距较大,可以抛弃这次请求
q 请求参数urlencode(request) request根据不同的服务采用不同的格式,具体见业务服务文档
s 请求签名md5(request + data_secret + ts) data_secret如上界面填入的秘钥。
开发者通过校验s,用来验证请求的合法性,防止恶意用户来拉取隐私数据


http具体业务服务

服务名 method 作用 具体描述
获取用户信息 getprofile 获取用户的详细信息,千牛会在用户接入列表和足迹插件显示用户信息 链接
设置用户信息 setprofile 修改用户的详细信息,客服可以在千牛足迹插件修改用户信息 链接
商品信息 getitemdetail 获取宝贝的详细信息,客服可以在千牛足迹插件看到用户当前浏览的宝贝详情 足迹定制 商品定制
交易信息 gettradefocus 获取交易的详细信息,客服可以在千牛足迹插件看到用户当前浏览的交易详情 足迹定制 交易定制

FAQ

关于此文档暂时还没有FAQ
返回
顶部