企业内部开发 服务端API 开发指南 基本概念介绍
基本概念介绍
最后更新:2023/10/27
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
基本概念介绍
最后更新:2023/10/27

目录

  • 术语介绍
  •       corpid
  •       userid
  •       部门id
  •       tagid
  •       external_userid
  •       agentid
  •       secret
  •       access_token
  •       应用可见范围
  • 术语介绍

    corpid

    每个企业都拥有唯一的corpid,获取此信息可在管理后台“我的企业”-“企业信息”下查看“企业ID”(需要有管理员权限)

    userid

    每个成员都有唯一的userid,即所谓“账号”。在管理后台->“通讯录”->点进某个成员的详情页,可以看到。

    部门id

    每个部门都有唯一的id,在管理后台->“通讯录”->“组织架构”->点击某个部门右边的小圆点可以看到

    tagid

    每个标签都有唯一的标签id,在管理后台->“通讯录”->“标签”,选中某个标签,在右上角会有“标签详情”按钮,点击即可看到

    external_userid

    企业外部联系人的id,可能是微信用户,也可能是企业微信用户。需要开发者(尤其是第三方开发者)注意的是,对于同一个外部联系人,不同调用方(企业/第三方服务商)获取到的external_userid是不同的。

    agentid

    每个应用都有唯一的agentid。在管理后台->“应用管理”->“应用”,点进某个应用,即可看到agentid。

    secret

    secret是企业应用里面用于保障数据安全的“钥匙”,每一个应用都有一个独立的访问密钥,为了保证数据的安全,secret务必不能泄漏。secret查看方法:
    在管理后台->“应用管理”->“应用”->“自建”,点进某个应用,即可看到。

    access_token

    access_token是企业后台去企业微信的后台获取信息时的重要票据,由corpid和secret产生。所有接口在通信时都需要携带此信息用于验证接口的访问权限

    应用可见范围

    每个应用都可配置可见范围,可见范围决定了哪些成员可以在企业微信终端的工作台使用该应用;可见范围同时也是应用的权限范围,决定了应用可以为哪些成员调用接口。
    可见范围可以配置成员、部门与标签。当配置的是部门,则部门下的所有子部门及成员都在可见范围。当配置的是标签,则标签下的所有部门与成员都在可见范围。
    特别地,通讯录同步助手不需要配置可见范围,其权限范围默认是全公司(即根部门)。

    上一篇
    开发前必读
    下一篇
    获取access_token