第三方应用开发的流程与概念

开发者，你好，欢迎来到企业微信第三方应用开发教程第一课。

企业微信第三方应用与服务商企业、第三方应用、客户企业、客户企业员工多个角色都有关联。从服务商企业开发应用，到企业客户安装使用应用，整个流程的链路环节较长，并且涉及到较多的概念。
本教程将带领开发者一起，通过一个最小应用开发的基本流程讲解，帮助开发者理解与应用开发相关的基本概念。

通过本节教程，开发者将了解：

1. 第三方应用开发的基本流程
2. 第三方应用开发的基本概念

应用接入流程

从第三方应用整个项目周期的接入流程来看，主要分成两个阶段：

一、应用开发阶段

1. 创建应用，配置基本信息
2. 开发应用，测试应用逻辑
3. 上线应用，提交审核信息

二、应用推广阶段

1. 服务商自有渠道推广
2. 企业微信应用市场推广

作为第三方应用的开发人员，主要的精力会聚焦应用的开发阶段，即从应用的创建、开发测试，再到应用的上线的这个流程。

为了帮助开发者对第三方应用开发的基本模式有一个清晰的理解，本教程将从开发人员开发应用的实际开发过程来讲解这个流程，并且结合每个阶段的工作，来引出当前这个阶段所需要和必须理解的基本概念，尽可能减少理解的成本。

基本流程

第三方应用开发的核心模式大致分为四阶段：

一、前期应用准备

创建应用
填写应用的名称、描述、图标等基本信息；选择应用需要使用的基本权限，比如通讯录权限、组织架构权限和企业客户权限等；填写应用主页、可信域名、回调服务等开发信息。

获取 suite_id 与 suite_scret
应用创建成功后，在应用详情页的基本信息，可以查看该应用的唯一身份标识 suite_id 和 对应的调用身份密钥 suite_secret 等，这些是用于后续应用授权等操作的重要参数，须妥善保管。

请参考开发教程 一：如何创建第三方应用

二、基础环境搭建

获取第三方应用凭证
企业微信服务会向第三方应用服务器定时推送该第三方应用的 `suite_ticket，在成功接收到 suite_ticket 后，连同应用创建时得到的 suite_id , suite_secret 作为参数，调用 获取第三方应用凭证接口 得到第三方应用凭证 suite_access_token。

suite_access_token 在应用授权阶段非常重要，用于获取第 三方应用的预授权码，获取授权企业信息等。

请参考开发教程 二：如何接收企业微信回调与 三：获取第三方应用凭证。

三、企业授权安装

获取临时授权码
企业管理员通过服务商官网的授权链接，或企业微信官方应用市场，授权安装第三方应用 时，将得到该企业对应于该第三方应用的 临时授权码 auth_code。

请参考开发教程 四：如何将应用安装到企业工作台

获取永久授权码
第三方应用服务后台通过使用 auth_code 与上一步得到的 suite_access_token 作为参数， 调用 获取永久授权码 接口，便能够获得企业永久授权码 permanent_code。

permanent_code 是记录企业授权第三方应用的唯一凭证，该授权码永久有效，须妥善保管。

请参考开发教程 四：如何将应用安装到企业工作台

四、调用企业接口

获取登录用户身份
企业授权安装第三方应用后，企业员工可通过企业微信工作台打开该应用。在打开应用页面时使用 网页授权链接 的重定向，得到一个可以换取当前访问用户身份的 code。通过 code 与 suite_access_token 调用 获取访问用户身份 接口即可得到当前访问用户的 user_id 等基本信息。

请参考开发教程 五：如何获取登录用户信息

获取企业凭证
第三方应用服务在调用企业业务接口前，比如通讯录管理、向成员推送应用消息等企业业务场景，需要先通过 获取企业凭证 接口将 permanent_code 换取成企业凭证 access_token。

access_token 是用于操作授权企业相关接口的统一凭证，所有的企业数据接口都依赖这个凭证，须妥善保管。安全起见 access_token 有一定的有效期，第三方应用服务在使用前，须确保当前 access_token 有效。
调用企业接口
在获得 access_token 后，可以结合企业内的业务逻辑，进行通讯录管理、消息推送、审批单据等能力接口的调用。

请参考开发教程 六：如何向成员发送消息 与 七：如何提交上线第三方应用

所以，企业微信第三方应用开发的基本流程大致如图所示，在这个简化的流程中，目前仅需要关注几个核心的概念即可。

基本概念

虽然与第三方应用相关的概念较多，本教程中仅列举出开发第三方应用过程最常见也最必须的一些概念：

第三方应用相关

• suite_id
  第三方应用 ID，是每一个第三方应用的唯一身份标识。
  
• suite_secret
  第三方应用密钥，是第三方应用对应的调用身份密钥，与 suite_id 配套使用。
  
• suite_ticket
  第三方应用票据，与 suite_id、suite_secret 配套使用，用于获取suite_access_token。
  
• suite_access_token
  第三方应用凭证，是通过 suite_id、suite_secret 、suite_ticket 换取而来的，代表第三方应用的身份的凭证，用于获取第三方应用的预授权码，获取授权企业信息等。

企业授权相关

• pre_auth_code
  预授权码，是用于企业授权时的第三方服务商安全验证。预授权码仅用于企业从服务商网站链接授权安装的场景，企业进行授权后，第三方应用后台将收到临时授权码。
  
• auth_code
  临时授权码，是企业对第三方应用进行授权时，第三方应用服务收到的一个临时授权的标记，收到临时授权码之后应该尽快换取成永久授权码 permanent_code。
  
• permanent_code
  企业永久授权码，是记录企业授权第三方应用的唯一凭证，该授权码永久有效。通过 auth_code 和 suite_access_token 换取得到。

企业相关

• corp_id
  企业ID，每个企业都拥有唯一的企业身份标记。
  
• access_token
  企业凭证，access_token是企业后台去企业微信的后台获取信息时的重要票据，由corpid和secret产生。所有接口在通信时都需要携带此信息用于验证接口的访问权限。

成员相关

• user_id
  员工ID，企业员工在企业内的唯一身份标记。

结语

在本节教程中，我们了解了企业微信第三方应用的开发流程和基本的概念。在下一节教程，我们将开始真正的实操，创建一个第三方应用，并且配置基本信息，为开发第一个应用做准备。