商品接入类型

京东AI市场为合作伙伴和用户提供云市场平台支撑,支持合作伙伴多种交付方式的云商品类型入驻,包括SaaS类、解决方案类、API 类和硬件类交付模式。 四大业务接入类型,支持服务商所有商品入驻。

发布API类商品操作指导

操作步骤

1.进入服务商中心页面。

2.单击左侧导航的“产品管理 > API > 新建产品”。

avatar

3.根据页面提示,设置基本信息,点击保存

avatar

4.根据页面提示,设置基本信息,点击提交审核,京东会对您提供的商品信息进行审核,只有所有信息通过审核,您发布的商品才会正式上架。

avatar

发布SaaS类商品操作指导

1.发布SaaS类商品之前,您需要遵循SaaS类产品接入指南进行接口开发调测,以供京东AI市场调用。

2.发布SaaS类商品之前,请先进行应用接入调试,京东AI市场提供了应用接入调试功能,请参看应用接入调试,务必保证对应场景的生产接口都能调试通过,系统会针对调测通过的用例进行保存用于商品发布时校验,以保证用户购买您的SaaS商品后,能够正常开通

操作步骤

1.进入服务商中心页面。

2.单击左侧导航的“产品管理 > SaaS > 新建产品”。

avatar

3.添加商品信息

avatar

4.为方便服务商对接NeuHub以及用户购买SaaS应用后可直接点击使用服务,NeuHub应用平台采用了oAuth作为免登陆以及账号打通的解决方案,服务商流程图如下:

avatar

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签名规则

响应示例

  1. 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.单击左侧导航的“产品管理 > 解决方案 > 新建解决方案”。

avatar

3.根据页面提示,设置基本信息,点击保存,京东会对您提供的商品信息进行审核,只有所有信息通过审核,您发布的商品才会正式上架。

注意: 图标建议长宽为300240px ,仅支持jpg和png格式,小于1M,请使用业务相关图标,而非企业商标。 为了保持页面体验的一致为美观,您上传商品图片的宽度建议为1128px。

avatar

发布硬件类商品操作指导

操作步骤

1.进入服务商中心页面。

2.单击左侧导航的“产品管理 > 硬件 > 新建硬件产品”。

avatar

3.根据页面提示,设置基本信息,点击保存,京东会对您提供的商品信息进行审核,只有所有信息通过审核,您发布的商品才会正式上架。

avatar

avatar

avatar

avatar

Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2020-10-30 03:35:04

results matching ""

    No results matching ""