蘑菇街开放平台

在蘑菇街开放平台，第三方接入用户若想使用店铺、商品、交易、联盟等相关API，需按特定流程完成对接。以下是详细的操作步骤，能帮助你顺利接入蘑菇街开放平台。

开放平台对接整体流程

对接蘑菇街开放平台，需依次完成以下步骤： 1、申请成为开发者

2、创建应用

3、应用开发测试

4、应用上线

5、应用下线

申请成为开发者

第三方接入用户需先注册蘑菇街用户，再通过主站账号注册为开放平台开发者，未注册蘑菇街的用户，需先前往主站完成注册。

1、进入开放平台后点击【登录】，跳转至主站登录页面。未注册用户需先在主站注册，公司、企业注册时需使用法人信息，避免因人员变换带来不便。

2、登录成功后，可通过右上角用户昵称下拉菜单的【用户中心】，或导航栏中的【控制台】，进入开发者注册页面。

3、若当前登录账号未认证，系统会引导进入认证流程。个人、个体用户需申请个人认证，公司、企业需申请企业认证，只有认证通过才能继续后续操作。

个人认证：个人、个体用户提供身份证实名信息和手持身份证完成认证后，可以个人身份注册成为开发者，点击“进入认证”即可开始。

企业开店认证：公司、企业提供营业执照等相关证件后，能以企业身份注册成为开发者。已完成个人认证的用户，可申请个人转企业认证，点击“进入认证”启动流程。

4、认证通过后，点击“已认证，下一步”按钮进入开发者注册页面，按要求录入基本信息，最后点击【提交】，完成开发者注册。目前仅支持企业开发者，务必按规定提供必要的资质证书。需填写的基本信息如下：

• 联系人姓名（必填）
• 手机号（必填，需填写并获取短信验证码）
• 邮箱（必填）
• 详细地址（必填）
• 开发者类型（选择企业开发者，必填）
• 客服电话（用于用户问题反馈，必填）
• 客服邮箱（必填）
• 服务商名称（必填）
• 服务商图标（需本地上传）
• 公司网址（选填）
• 服务商介绍（含成功案例，需本地上传）
• 勾选“我已阅读并且同意 蘑菇街服务商合作条款”

提交开发者申请后，需等待审核，审核周期通常为5-10个工作日。期间请留意邮件与短信通知，及时获取审核结果。若申请资料不全，开放平台会告知审核不通过的原因，申请人需根据反馈修改注册信息，重新提交审核。

创建新应用

注册成为开发者后，可在【控制台》应用列表】页面创建应用。操作时先填写应用基本信息，完成后点击下一步，选择需要申请的API列表，可通过API分组申请权限，具体流程分为四步：申请应用→申请权限→审核应用→完成。创建应用后，能获取SDK和对应的接口权限。

1、填写应用基本信息（带*为必填项）：

• 应用名称：填写
• 回调地址：填写应用的回调地址
• 应用头像：本地上传
• 应用类型：自行选择
• 应用描述：详细填写应用相关介绍

2、填写完基本信息点击“下一步”，进入API权限申请环节。部分API信息如下： • 商品API

• 店铺API

提交申请后，开放平台会根据提交的信息审核用户访问API的请求，审核通过后，用户可以对应用进行测试开发。

测试应用

开放平台提供API测试工具，供开发者测试应用。具体操作路径为：在首页发布流程中点击“Api”，进入API详情页面，再点击【Api测试工具】即可进入测试界面。

测试界面中会显示以下信息：

• 返回格式(Format)：JSON
• API请求参数(API Request)
• API类目(API Category)：如商品API1，可查看Api说明
• API名称(API Name)：如xiaodian.item.get
• 数据环境(environment)：OFFLINE
• SDK类型(SDK Language)：JAVA
• AppKey、AppSecret
• 调用链接：如 http://10.13.134.148/invoke?access_token= od=xiaodian.item.get&format=json&timestamp=1528879645247&sign=DB743A53F5D46F&itemId= &app_key=&meth
• itemId(string)：需填写对应参数
• 功能按钮：提交测试(Execute)、绑定用户(Authorize)
• API返回结果(API Response)：例如可能出现 "{}, "result": { "status":{ "data": () "code":"1101404", "msg":"商品不存在或已被删除"}, "success": false}"

进入测试页面后，在左侧分别录入系统级输入参数、应用级输入参数，点击【提交测试】，就能在右侧查看当前API的调用结果。

应用操作

所有应用操作都集中在【控制台》应用列表】的操作栏中，可进行测试API、申请API权限、上/下线应用以及查看应用监控等操作，应用列表展示信息如下：

1、上线/下线

应用开发完成后，执行上线操作就能获取正常流量，否则流量会被限制在1qps/s，新创建的应用默认处于线下状态，应用下线后，将不再提供服务。

2、API权限申请

应用API权限申请入口位于操作栏，申请权限后需等待审批，审批通过才能调用对应API。若未通过审批或未申请权限，调用时会返回 "API未订阅或者审批未通过"(0000009) 错误。

3、监控

通过监控功能，开发者能了解应用调用蘑菇街开放平台API的情况，及时根据数据调整应用。

4、测试

测试功能可用于测试应用API调用，也能作为故障排查的工具。需要注意的是，此处进行授权操作，也会更新用户对该应用的AccessToken。