商品接入类型
京东AI市场为合作伙伴和用户提供云市场平台支撑,支持合作伙伴多种交付方式的云商品类型入驻,包括SaaS类、解决方案类、API 类和硬件类交付模式。 四大业务接入类型,支持服务商所有商品入驻。
发布API类商品操作指导
操作步骤
1.进入服务商中心页面。
2.单击左侧导航的“产品管理 > API > 新建产品”。
3.根据页面提示,设置基本信息,点击保存
4.根据页面提示,设置基本信息,点击提交审核,京东会对您提供的商品信息进行审核,只有所有信息通过审核,您发布的商品才会正式上架。
发布SaaS类商品操作指导
1.发布SaaS类商品之前,您需要遵循SaaS类产品接入指南进行接口开发调测,以供京东AI市场调用。
2.发布SaaS类商品之前,请先进行应用接入调试,京东AI市场提供了应用接入调试功能,请参看应用接入调试,务必保证对应场景的生产接口都能调试通过,系统会针对调测通过的用例进行保存用于商品发布时校验,以保证用户购买您的SaaS商品后,能够正常开通
操作步骤
1.进入服务商中心页面。
2.单击左侧导航的“产品管理 > SaaS > 新建产品”。
3.添加商品信息
4.为方便服务商对接NeuHub以及用户购买SaaS应用后可直接点击使用服务,NeuHub应用平台采用了oAuth作为免登陆以及账号打通的解决方案,服务商流程图如下:
4.1 请求授权服务器获取临时授权码(认证服务器302跳转)
请求示例
1. RequestURL: /auth/authorize?redirect_uri=https://baidu.com&state=123_456&client_id=4E63EAC1E4248F0AB552DCEF5EE66058&response_type=code&source=s
2. Request Method: GET
3. Status Code: 302 Found
响应示例
1. response header:
Location: https://baidu.com?state=123_456&code=zNppPPswrTntcHt
参数名 | 参数类型 | 是否必选 | 描述 |
---|---|---|---|
redirect_uri | String | 必选 | 临时授权码 |
state | String | 必选 | 与请求一致 |
client_id | String | 必选 | 应用id |
response_type | String | 必选 | 此知必须为code |
source | String | 可选 | 使用子账号登录时此值为s,主账号登录无需传该值 |
认证服务器收到请求,根据client_id和请求cookie中的用户信息以及用户的购买情况判断用户是否可以进行授权,弱验证通过,认证服务器分配临时授权码code,立即跳转至第三方提供的跳转地址。该码的有效期应该很短,通常设为10分钟,客户端只能使用该码一次,否则会被授权服务器拒绝。该码与客户端ID(client_id)和重定向URL,是一一对应关系。
备注
如果客户端的请求中包含state参数,认证服务器的回应也必须一模一样包含这个参数。
4.2 令牌请求(获取授权令牌)
客户端向认证服务器申请令牌的HTTP请求
请求示例
1. RequestURL: /auth/token?grant_type=authorization_code&code=qbBUVvMTDBhvHwY&redirect_uri=https://baidu.com&client_id=4E63EAC1E4248F0AB552DCEF5EE66058&sign=0433e3038e208089eb74b7d9c8f5725f
2. Request Method: GET
3. Status Code: 200 OK
请求参数:
参数名 | 参数类型 | 是否必选 | 描述 |
---|---|---|---|
grant_type | String | 必选 | 表示授权类型固定为" authorization_code " |
client_id | String | 必选 | 客户端的ID (appKey,32位) |
redirect_uri | String | 必选 | 重定向URL |
code | String | 必选 | 认证服务器分配的临时授权码 |
sign | String | 必选 | 使用appsecret和请求参数生成的签名值,见下方sign签名规则 |
响应示例
- response body
{ "msg":"success", "code":1, "data":{ "access_token":"lzFVeGZXWjQswHq", "auth_info":{ "user_info":{ "current_user_type":"main", "master_user_id":"master_00000131" }, "purchased_saas_version_info":[ { "ver_name":"基础版", "app_ver":"v1.0", "expire_time":"2020-05-21 10:51:12" } ], "client_id":"AB174EBEE6795B89C3270EB5F5ABADEA" }, "expire_in":"3600", "token_type":"bearer" } }
响应参数
参数名 | 参数类型 | 是否必选 | 描述 |
---|---|---|---|
code | Integer | 必选 | 1代表成功;0代表失败 |
access_token | String | 必选 | 访问令牌(32位) |
current_user_type | String | 必选 | main 主账号;sub 子账号 |
master_user_id | String | 必选 | 主账号id |
purchased_saas_version_info | String | 必选 | 已购应用列表 |
ver_name | String | 必选 | 版本名称 |
app_ver | String | 必选 | 应用版本 |
expire_time | String | 必选 | 应用过期时间 |
token_type | String | 必选 | 固定 bearer |
expires_in | String | 必选 | token过期时间,单位为秒 |
备注
相关参数使用JSON格式发送(Content-Type: application/json)。此外,HTTP头信息中明确指定不得缓存。
4.3 sign签名规则
规则说明
1. 将请求参数key值按字典序进行排序
2. 将请求参数key-value按照 a=1&b=2&c=3 的方式进行拼接
3. 头尾拼接应用的appsecret值,如:假设appsecret值为xyz则拼接的字符串为xyz a=1&b=2&c=3xyz
4. 拼接后的字符串进行md5加密
示例说明
用户请求参数
a=1, c=3 ,b =2
应用的appsecret值 xyz
拼接规则为 md5(xyza=1&b=2&c=3xyz) = 3404eab5a848dd893b571e9783427f30
发布解决方案类商品操作指导
操作步骤
1.进入服务商中心页面。
2.单击左侧导航的“产品管理 > 解决方案 > 新建解决方案”。
3.根据页面提示,设置基本信息,点击保存,京东会对您提供的商品信息进行审核,只有所有信息通过审核,您发布的商品才会正式上架。
注意: 图标建议长宽为300240px ,仅支持jpg和png格式,小于1M,请使用业务相关图标,而非企业商标。 为了保持页面体验的一致为美观,您上传商品图片的宽度建议为1128px。
发布硬件类商品操作指导
操作步骤
1.进入服务商中心页面。
2.单击左侧导航的“产品管理 > 硬件 > 新建硬件产品”。
3.根据页面提示,设置基本信息,点击保存,京东会对您提供的商品信息进行审核,只有所有信息通过审核,您发布的商品才会正式上架。