应用开发
应用开发
第一步：创建应用
进入管理后台-服务商-应用管理-创建应用
应用的基本信息：
| 信息项 | 要求及说明 |
|---|---|
| 应用Logo | 应用的Logo，小于5M，640 * 640，在授权页会被用于展示。 |
| 应用名称 | 应用的名称，建议包含品牌名，2-8个字内 |
| AppID | 应用ID，系统分配，用于调用第三方应用相关接口 |
| 功能分类 | 应用提供的服务类型，如客户关系、团队协同、文化建设等。一个应用只能拥有一个分类。应用将会在如流企业管理后台应用市场中显示在对应的分类中，请依据实际情况进行选择 |
| 通讯录权限 | 标识应用可以对授权企业的通讯录进行哪些操作，分为通讯录信息只读、通讯录信息读写。 |
| 桌面端访问地址 | 从如流桌面客户端应用中心进入应用时会直接跳转到对应的URL，支持使用{corpId}模板参数表示CorpID例如： https://example.com/?key={corpId}，用户进入应用时平台会替换{corpId}为用户所在企业的真实CorpID |
| 移动端访问地址 | 从如流移动客户端应用中心进入应用时会直接跳转到对应的URL，支持使用{corpId}模板参数表示CorpID例如：https://example.com/?key={corpId}，用户进入应用时平台会替换{corpId}为用户所在企业的真实CorpID |
| 应用后台地址 | 应用的管理后台地址，企业授权安装应用后，如还需进行业务设置才可使用应用，可以将业务设置地址填写到此，授权企业的管理员可从企业管理后台的应用详情页免登录直接跳转该链接，详见服务端API-应用管理后台 |
开发信息：
| 信息项 | 要求及说明 |
|---|---|
| SuiteID | 系统分配，用于调用第三方应用相关接口 |
| SuiteSecret | 系统分配，用于调用第三方应用相关接口 |
| SuiteTicket | 系统分配，用于调用第三方应用相关接口 |
| 授信域名 | 在该域名下发起的授权请求才可被通过，企业点击授权链接时，如流平台会检查该域名是否已登记 |
| 安装事件回调地址 | 在第三方应用授权流程中，授权成功后会回调该地址，返回临时auth_code。你需用auth_code换取永久授权码，请尽量将此域名与发起授权域名保持一致。开发者在收到回调后需要在3s 内尽快返回{"errcode": 0}，否则在授权安装时将出现安装失败 |
| 消息和事件接收URL | 如流 平台会将用户消息和事件发送到此URL，保存时如流平台会发送一条POST验证消息到填写的URL，企业的接收消息服务器接收到验证请求后，需要作出正确的响应才能通过URL验证，详见服务端API中管理应用-接收消息和事件-验证URL有效性 |
| Token | 用于生成签名，校验回调请求的合法性。可任意填写或随机获取 |
| EncodingAESKey | 回调消息加解密参数，是AES密钥的Base64编码，用于解密回调消息内容对应的密文。后续所有托管的企业产生的回调消息都使用该值来解密。可任意填写或随机获取 |
第二步：测试应用
应用创建成功后，服务商可自行授权测试该应用。点击应用详情-开发信息-安装测试
每个应用的未上线版本目前仅允许10个不同如流企业授权测试，应用必须在上线后才可以被更多企业授权安装；
每个企业针对每个应用的未上线版本和线上版本只能安装一个；
安装测试时系统会校验各种配置的完整性及连通性；
进入应用需要调用OAuth2.0授权来获取企业内成员的唯一ID，用于识别成员身份，不得有进入应用的二次登录环节。
第三步：应用上线
申请条件
- 服务商已完成企业认证。
- 应用功能流程完整可用，完成充分自测且无严重BUG，准备填写完整的质量验收报告。
- 上线为应用的一个开发状态，只有申请上架到应用市场的应用才可以被用户在市场中搜索和查看。
上线流程
- 服务商进入应用详情—上线管理—申请上线。
- 如流团队会在3个工作日内完成审核，审核结果会通过“企业管理助手”通知申请人。
修改应用
修改应用：应用基本信息修改并重新提交审核，通过后所修改的应用信息才会覆盖到所有已授权的企业（应用名称除外）；应用开发信息修改后立即生效；
下线应用：进入应用详情-上线管理，可以下线应用。应用下线后将不再提供给新的企业授权使用，但不影响所有已授权的企业使用；
删除应用：在应用详情页可以删除应用。但曾经上线，且已被企业授权使用的应用不允许删除。
