京东联盟API开发指南

一-认识京东联盟API,获取APPkey和APPsecret

做过淘客开发的一定接触过淘宝API开发。

而做京东联盟软件自然离不开京东联盟API。

京东联盟API目前上线的有很多。

https://jos.jd.com/api/list.htm?id=117

Paste_Image.png

但是京东联盟API获取比较难，没办法在线申请，需要找官方手工申请。

申请步骤略过，一般个人很难申请到。

如果你有幸申请API，这系列文章可能能帮助你快速入门。

打开京东宙斯首页，进入控制台。

https://jos.jd.com/

Paste_Image.png

进入 应用管理->新建应用

Paste_Image.png

应用标签选择买家->无线应用

Paste_Image.png

这里需要填写回调URL

Paste_Image.png

回调URL作用是授权是京东联盟给服务器返回的数据。
如果是做WEB开发的，需要提交一个有效的地址涌来接收code，根据code再获取session，
如果是做软件开发的这里随便填写个地址就可以了。

填写好后点击下一步

Paste_Image.png

回到 基本信息->提交审核

Paste_Image.png

正常情况下是直接到上线运行

Paste_Image.png

点击应用证书，此时证书流量是 300k/天。

Paste_Image.png

至此，已经成功获取了AppKey和AppSecret。

二-京东联盟API授权的两种方式

授权的目的是为了获得Access token
正式上线的获取的Access token有效期是一年。
授权文档的详细介绍如下。

http://jos.jd.com/doc/channel.htm?id=152

WEB授权方式

在应用信息里点击测试

Paste_Image.png

按照提示登录账号授权。

登录的账号为有APPKEY权限的账号，否则不能正常使用

https://www.baidu.com/?state=null&code=0KdJhU

这里得到的code，0KdJhU，拼装参数如下。
https://oauth.jd.com/oauth/token?grant_type=authorization_code&client_id=70E10438C20C3C6F900D18F0A5FD1BF6&
redirect_uri=http://www.baidu.com&code=0KdJhU&state=1212&client_secret=b9ec2d0e4370441a941e9a8b6e0ba1e6
在浏览器里打开，就可以得到access_token

Paste_Image.png

客户端授权方式

客户端授权方式相对简单一些，拼装如下参数

https://oauth.jd.com/oauth/authorize?response_type=code&client_id=70E10438C20C3C6F900D18F0A5FD1BF6&redirect_uri=urn:ietf:wg:oauth:2.0:oob&state=1212

在浏览器里访问可以直接获得access_token

Paste_Image.png

三-京东联盟API调试工具

通过前两篇文章，我们获取到了所需的数据。

App Key：70E10438C20C3C6F900D18F0A5FD1BF6
App Secret： b9ec2d0e4370441a941e9a8b6e0ba1e6
授权码:051de848-426b-471a-ae15-b4728e36d208

那么怎么测试数据是否正确呢？

测试获取爆款商品

我们以 获取爆款商品（jingdong.UnionThemeGoodsService.queryExplosiveGoods） 为例
API文档:
https://jos.jd.com/api/detail.htm?apiName=jingdong.UnionThemeGoodsService.queryExplosiveGoods&id=1814

点击API测试工具，输入对应的参数。

Paste_Image.png

如下图所示表示调用成功

Paste_Image.png

优惠券,商品二合一转接API-通过unionId获取推广链接

此API和生成二合一的推广链接

Paste_Image.png

京东二合一的效果

Paste_Image.png

四-开发京东联盟API易语言版SDK

京东联盟API提供了java版，PHP版，.net版

Paste_Image.png

惯例，易语言SDK肯定要自己开发。

之前大华发不过淘客API的SDK，两种授权方式基本一致。

官方的文档

http://jos.jd.com/doc/channel.htm?id=157

Paste_Image.png

开发规范一、二、三是基本参数介绍。
其中timestamp和sign是需要关注的。

timestamp

Paste_Image.png

sign

SIGN主要有4步

Paste_Image.png

拼装参数并排序

Paste_Image.png Paste_Image.png Paste_Image.png

五-京东联盟API一个大坑

不少媒体好不容易拿到京东联盟API。

可是发现竟然调用不了。

询问负责人，确定API权限没问题。

那么问题出现在哪里呢？

按照正常逻辑

媒体A拿到APPKEY的权限，开发应用给用户B,C,D,E使用。

使用过程中需要B,C,D,E授权得到一个session。

可京东联盟API设计的却非常奇葩，这个session（access_token），必须是A账户授权的。

注意了，必须是有APPkey权限的账号授权才能使用哦。