顺丰开放平台开发者接入指引

开发者接入主要是接入方通过使用顺丰API方式完成自有系统的对接，在接入方触发业务场景时调用已调试成功的顺丰服务API完成业务请求。

注：专线对接客户请提前联系客户经理确认对接方案后再进行对接。

一、接入条件

如贵公司满足以下场景之一，可选择此方式接入。

（1）公司有自己的业务系统，并具备研发能力。

（2）公司需要将顺丰服务集成到自己的应用中。

二、收费标准

使用顺丰服务API目前全部免费，如有收费API将在接口文档中标识。

三、接入步骤

步骤1：登录LaaS开放平台

如果您已有开放平台账号，可直接使用账号密码登录。如果您已有月结管家/速打平台/数据灯塔账号，可选择对应登录方式直接登录。如果您是顺丰内部员工，可选择顺丰工号登录方式完成域账号登录。

如果您是首次与顺丰合作，可通过注册平台账号后登录。

步骤2：完成用户认证

进入“控制台”，在控制台首页点击【立即认证】，根据实际情况选择“个人认证”或“企业认证”。

认证流程

1、完成安全验证

2、完善用户信息

3、选择认证方式

个人认证支持“证件照认证”

企业认证支持“企业证照认证”

4、提交认证材料

根据选择的认证方式，提交对应认证资料。

个人认证需要提交身份证号及身份证扫描件或图片完成认证

企业认证需要提交三证信息及营业执照扫描件或图片完成认证

步骤3：创建应用

在“控制台-业务中心”选择“业务对接-开发者对接”，点击【新建应用】按钮创建应用。每个应用对应您需要接入顺丰服务的单个系统，平台将为每个应用分配独立的对接账号（顾客编码）及密钥（校验码）。

1、填写应用信息

2、完成应用创建

步骤4：关联API

当应用创建成功后，进入应用的API列表页面点击【关联API】按钮可选择需要关联到应用的服务接口。

点击【关联】按钮将已选择的服务接口添加到应用API列表。

步骤5：API联调上线

按页面提示完成API配置、测试及上线。

API状态根据上线流程可分为：

待配置 ：根据实际情况完成接口关键属性配置，对于不需要配置的接口，平台默认不显示此状态，直接切换为“测试中”。

测试中 ：在沙箱环境自助联调接口。点击【测试】按钮可选择下载API-SDK或使用在线测试工具联调。点击【配置】按钮修改接口属性，点击【查看】按钮查询已配置的接口属性。

待上线 ：平台检测到API已具备切入生产环境条件（接口7天内测试成功3次以上，若为下单接口，需通过面单审核或配置免面单，具体参考面单部分说明）。点击【上线】按钮可完成接口上线。

已上线 ：API已切入生产环境条件，可正常调用生产环境接口地址。

注：新用户需对接使用云打印接口，上传云打印面单进行审核，审核通过后才能完成下单接口上线操作。