文档中心

接入指南

更新时间: 2016-10-21
一、应用接入流程

二、接入流程说明

1、入驻开放服务平台

a)我是供应商

一、苏宁供应商入驻开放服务平台,可通过以下2种方式:

(一) 具备一个开放平台邮箱账号,可直接使用开放平台账号登录开放服务平台。

(二) 如果没有开放平台邮箱账号,可以使用供应链账号在开放服务平台绑定一个邮箱,使用该邮箱账号登录。

二、完善电子商务业务联系人信息,完成开放服务平台的入驻。

b)我是商户

商户入驻开放服务平台,流程如下:

一、使用苏宁云台商户账号登陆开放服务平台

二、完善电子商务业务联系人信息,完成开放服务平台的入驻。

c)我是服务商

苏宁开放服务平台服务商入驻流程如下:

第一步:资质及产品评估:

首先请您将以下内容通过邮件发送给 API@cnsuning.com

(1) 企业的基本信息简介(包含:公司介绍、研发、售后团队规模),并请提供以下四种证件的电子版,营业执照副本(通过最新年检)、组织机构代码证、税务登记证(国税及地税)、开户许可证。

(2) 企业产品介绍,或将基于苏宁开放服务平台开放的API接口开发的产品介绍。

(3) 贵公司的详细地址及此项业务联系人详细信息;

第二步:我们将在2个工作日内对您发来的信息进行评估。

第三步:评估通过后,苏宁将开放登录权限。随后进入应用开发、测试及上线流程。

 


2、获取证书

一、开放服务平台用户可通过创建应用获取证书。

创建应用过程:http://open.suning.com/ospos/apipage/toDocContent.do?menuId=18

二、 获取证书成功后,每个证书中包含一个appkey。

 


3、开发测试

一、 开发测试阶段,应用需要在沙箱环境进行开发,开发完成后可选择正式环境测试;

二、供应商、商户API的调用量是30万次/天;ISV(软件服务商)API的调用量是100万次/天。

 


4、申请发布

一、申请发布需要填写应用相关信息后才可以提交。

二、 回调地址的定义:

对于ISV(软件服务商)来说,如果您的应用是Web应用,则需要在进入正式环境测试时,注册一个后台回调地址,用户在通过开放服务平台来访问您的应用的时候,开放服务平台会把相关的上下文参数和token通过这个回调地址传给您。

前台回调地址:能够证明公司可信度的网站或官方网站

 


5、应用审核

一、 应用开发完成后,提交上线审核,审核周期从提交时间算起3个工作日。

二、 审核未通过修改后可再次提交申请,审核周期从再次提交申请时间算起3个工作日。

三、 审核通过即可在开放服务平台销售提供服务。

四、 应用审核关注的重点是应用功能和安全性,具体审核规则细节详见应用发布审核规则。

 


6、上线运行

一、申请发布并审核通过后,应用为上线运行状态,该状态调用API可按照线上流量规则运行。

二、 上线运行状态,每个appkey默认拥有基础开放的权限。

三、 上线运行状态,除回调地址外应用的基本信息可以自行修改。

三、FAQ

Q1:什么是证书?

A1:证书指的是开发者在SOS创建应用是默认给开发者的应用开发证书。证书包含四个内容: 证书编号:App Key 证书密钥:App Secret 接口权限:开发者可以调用的API权限,包含基础开放与增值包 证书流量:应用可以调用API的流量限制 也就是权限+流量+appkey+app secret=证书,每个应用都有对应的应用开发证书,在应用创建时开发者获得证书。



Q2:什么是App Key?

A2: App Key是应用的唯一标识,SOS通过App Key来鉴别应用的身份。

 


Q3:什么是App Secret?

A3: App Secret是SOS给应用分配的密钥,开发者需要妥善保存这个密钥,这个密钥用来保证应用来源的可靠性,防止被伪造。



Q4 :如何重置App Secret?(为充分保障应用安全,建议您定期重置secret

A4:重置App Secret,请在开发者中心-应用列表中,点击应用名称,进入应用详情页面,点击重置App Secret,重置后系统会立即分配新的Secret给当前操作的应用。

1、打开open.suning.com

2、打开页面上的控制台,如图​

3、点击重置即可,如图




Q5:应用可以删除吗?

A5:应用可以删除。删除规则为:对于应用列表中的应用,如果状态处于发布审核中、审核通过、运行中状态,则不可以删除,若不处于上述状态则可以点击进入应用点击左侧删除应用按钮进行删除。

 


Q6:什么是沙箱环境?

A6:沙箱环境是苏宁为您提供的一个模拟的测试环境,开发者可以在沙箱环境中完全仿真的测试开放服务平台接口的功能。在该环境下您可以使用任意App KeyApp Secret在此环境下进行开发和调试程序。在测试环境中可以完全模拟您所需要的业务逻辑操作,包括获取授权码,获取accesstoken,调用API接口。

 


Q7:什么是正式环境?

A7:正式环境是苏宁真实的线上环境,应用所进行的操作会对真实的交易数据产生影响。当程序在正式环境下顺利调试完成即可申请发布,这样您的程序就可以正常使用了。

 


Q8:测试环境下与正式环境下的API调用量有限制吗?

A8:测试环境,供应商、商户API的调用量是30万次/天;ISV(软件服务商)API的调用量是100万次/天。

 


Q9:苏宁开放服务平台应用及服务审核周期是多久?

A9:1、应用开发完成后,提交上线审核,审核周期从提交时间算起3个工作日。

        2、审核未通过修改后可再次提交申请,审核周期从再次提交申请时间算起3个工作日。

 


Q10:为什么要提交申请发布?上线运行和开发测试阶段区别是什么?

A10:申请发布后,才可以在不同的平台展示,并为终端用户提供服务;上线运行和开发测试阶段流量是不同的,开发测试阶段证书流量为5000/天,上线运行后,根据每个应用标签不同,执行不同的线上流量规则;因此避免影响您上线正常运行,请及时提交申请发布审核。

 


Q11:  因为修改回调地址流入审核流程,在审核中状态的API调用流量是多少?

A11:审核中状态的应用,API调用流量仍然延续发布成功后的流量规则。