第三方供应商入驻指南
- 平台概述
- 注册账号
- 创建应用
- 应用配置
- 应用开发部署
- 事件订阅
- 权限配置
- 对接平台统一账户体系
- 对接平台统一积分体系
- 版本管理与发布
# 平台概述
| 应用类型 | 开发者 | 使用人员 | 支持平台 | 是否支持上架到平台应用市场 |
|---|---|---|---|---|
| 自建应用 | 社区内部开发者或者委托的服务商开发者 | 安装了该应用的社区人员 | PC/浙里办/微信小程序/H5微应用 | 否 |
| 第三方应用 | 第三方服务商开发者 | 安装了该应用的社区人员 | PC/浙里办/微信小程序/H5微应用 | 是 |
# 注册账号
打开 统一登录界面，点击下方注册账号按钮，选择我是供应商模块，进入注册页面
提交注册申请，等待平台管理员审核
# 创建应用
- 在应用管理页面，选择第三方应用，然后单击新建应用。
- 填写应用的基本信息，然后单击确定
请保存好应用的AppSecret，后续无法在平台中查询到当前密钥信息
# 应用配置
应用创建后，在基础信息页可配置应用头像、名称、描述和所属场景。
若需要重置AppSecret，可点击重置密钥按钮，原先的AppSecret会立即失效
在应用详情页，单击开发管理，可配置应用的基本信息。
| 配置 | 是否必选 | 配置说明 |
|---|---|---|
| 应用类型 | 是 | 选择应用的类型。H5及微信小程序都支持通过统一门户微信小程序段接入访问 |
| 服务器出口IP | 是 | 输入调用API时使用的IP即企业服务器的公网IP，多个IP请以英文逗号","隔开，支持带一个*号通配符的IP格式。 |
| 后台回调地址 | 是 | 输入PC端URL，用于对接平台统一登录体系。 |
| H5微应用地址 | 条件必选 | 输入应用URL，在移动端工作台点击应用图标会跳转到此页面。可输入后端服务部署的服务器的IP或域名。例如： http://公网IP:8080。 |
| 应用额外权限 | 否 | 底座小程序会根据应用所需权限向微信申请 |
| 应用地址参数 | 否 | 应用需要的额外参数信息，通过“&”符号连接（userType=0&from=weChat&.....），平台会自动将参数拼接到入口URL上面 |
| 用户进入登录 | 是 | 游客（未绑定身份证），初级认证用户（实名认证），高级认证用户（实名认证+绑定房产）。在社区居民端小程序点击应用时会判断当前用户是否满足使用应用的权限，只有满足或者大于设置等级的用户才能进入应用。（高级认证用户 > 初级认证用户 > 游客） |
| 加密aes_key | 是 | 输入加密aes_key。参考配置事件订阅 |
| 请求网址 | 是 | 输入接受事件订阅的url，必须是公网可以访问的url地址。参考配置事件订阅 |
# 应用开发部署
# 事件订阅
应用会推送订阅的事件，例如用户新增、车辆新增、应用卸载等。通过订阅这些事件，可以更好地与应用集成。你只需告诉应用当某个事件发生时，需要推送消息到哪个URL，会以HTTP POST请求的方式将事件内容以JSON格式推送给你。
在事件订阅列表区域，开启要订阅的事件
# 权限配置
接口权限是以应用为维度授予的，每个应用的接口权限都是独立存在的，如果多个应用都需要调用同一个接口，那么每个应用都要添加相对应的接口调用权限。 例如：开发商内同时拥有A、B两个应用，且应用A已经拥有积分权限，此时如果应用B要获取积分，那么也需要添加积分权限，添加方式与应用A一样。
根据业务需求，单击申请权限，或批量选择要申请的接口权限，单击批量申请
若权限调整，需要重新上架应用
# 对接平台统一账户体系
平台提供统一的用户体系，通过本开放平台跳转进入的第三方应用从跳转URL中获取平台用户唯一标识和社区唯一标识，第三方应用自行维护用户id和社区id的关联信息，可通过用户id获取用户基础信息，可参考【数据仓开放文档】个案基础信息查询。通过第三方自有应用入口进入的用户，若没有平台用户唯一标识，需要调用平台用户注册接口，可参考【数据仓开放文档】个案基础信息上传，注册成功后会返回用户信息，第三方应用自行维护用户id。
需提前获取用户信息权限
获取跳转URL中的平台用户唯一标识和社区标识
https://你的应用跳转地址?orgId=社区唯一标识&accountId=平台用户唯一标识
# 对接平台统一积分体系
平台对各个应用积分进行统一管理，提供积分查询和积分上传接口，可参考文档【数据仓开放文档】积分查询和【数据仓开放文档】积分上传
需提前获取积分权限，第三方应用需要支持应用内部积分自定义配置。
# 版本管理与发布
在应用详情页面，单击版本管理与发布，单击对应版本的发布按钮。发布应用后，本组织便可以使用该应用了。
第三方应用需要上架至应用商城，发布成功点击上架按钮，选择对应的版本号上架，审核通过之后在应用商城可见。
