企业内部开发 服务端API 开发指南 基本概念介绍
基本概念介绍

目录

  • 术语介绍
  •       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有:

    • 自建应用secret。在管理后台->“应用与小程序”->“应用”->“自建”,点进某个应用,即可看到。
    • 基础应用secret。某些基础应用(如“审批”“打卡”应用),支持通过API进行操作。在管理后台->“应用与小程序”->“应用->”“基础”,点进某个应用,点开“API”小按钮,即可看到。
    • 通讯录管理secret。在“管理工具”-“通讯录同步”里面查看(需开启“API接口同步”);
    • 外部联系人管理secret。在“客户联系”栏,点开“API”小按钮,即可看到。

    access_token

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

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