第三方接入概述
应用接入目标
完成第三方应用接入可以达成以下目标：
- 创建应用并上架到指定的市场
- 为指定的学校授权安装应用
- 获得能够调用开放接口的 corp_access_token
整体接入流程总览
接口调用与回调接收流程
| 顺序 | 步骤 | 说明 | 接口链接 |
|---|---|---|---|
| 1 | 创建应用，上架应用市场 | 为回调服务开通回调请求 | |
| 2 | 接收回调推送 ticket，获得 suite_ticket | suite_ticket 用于调用 get_suite_token 接口 | 推送 suite_ticket |
| 3 | 调用 get_suite_token 获得 suite_access_token | suite_access_token 用于调用后续接入接口 | get_suite_token |
| 4 | 机构管理员安装应用 | 触发下一步应用安装回调 | |
| 5 | 接收回调请求，获得 auth_code | auth_code 用于获取永久授权码 | 授权成功通知 |
| 6 | 调用 get_permanent_code 获得永久授权码 | 永久授权码用于获取 corp_access_token | get_permanent_code |
| 7 | 调用 get_corp_token 获得 corp_access_token | corp_access_token 用于调用开放接口 | get_corp_token |
整个流程需要使用到以下两类接口
应用授权类接口
- 获取第三方应用凭证 get_suite_token
- 获取永久授权码 get_permanent_code
- 获取机构凭证 get_corp_token
回调通知接口
- 推送suite_ticket
- 授权成功通知
开发商注册和登录
申请注册为腾讯教育号的开发者，提交申请后，平台审核后会在三个工作日内告知您。申请成为教育号开发商的条件是与腾讯教育号有项目合作，线下会有运营人员与您对接。
申请通过后，可以登录平台创建应用，也可以添加企业其他开发者。具体注册细节见开发商注册章节
机构管理员授权应用
开发人员登录后，在统一应用接入平台创建应用、开发调试。完成在沙盒环境的调试后，您可以申请上架到指定机构。您的上架申请会由腾讯教育号运营后台审核。审核通过后，机构的管理员可以前往机构市场安装应用或者通过扫描应用授权二维码等方式，授权您使用机构的第三方应用接口。
开发商提供服务
机构管理员授权应用后，您即获取机构赋予的永久授权码。通过此授权码，第三方可以换取到企业的访问凭证，从而可以调用通讯录管理、消息推送、身份验证等相关接口。