Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
企业内部开发
智慧硬件开发第三方应用开发
企业内部开发
智慧硬件开发第三方应用开发
  1. 开发指南
  • 快速入门
    • 概述
  • 开发指南
    • 获取access_token
      GET
  • 通讯录管理
    • 成员管理
      • 获取加入企业二维码
      • 获取企业活跃成员数
    • 互联企业
      • 获取应用的可见范围
      • 获取互联企业成员详细信息
      • 获取互联企业部门成员
      • 获取互联企业部门成员详情
      • 获取互联企业部门列表
  • 客户联系
    • 客户管理
      • 客户联系规则组管理
        • 客户联系规则组管理-获取规则组列表
        • 客户联系规则组管理-获取规则组详情
        • 客户联系规则组管理-获取规则组管理范围
        • 客户联系规则组管理-创建新的规则组
        • 客户联系规则组管理-编辑规则组及其管理范围
        • 客户联系规则组管理-删除规则组
    • 客户标签管理
      • 管理企业规则组下的客户标签
        • 管理企业规则组下的客户标签-获取指定规则组下的企业客户标签
        • 管理企业规则组下的客户标签-为指定规则组创建企业客户标签
        • 管理企业规则组下的客户标签-编辑指定规则组下的企业客户标签
        • 管理企业规则组下的客户标签-删除指定规则组下的企业客户标签
    • 联系我与客户入群方式
      • 客户联系「联系我」管理
        • 更新企业已配置的「联系我」方式
        • 删除企业已配置的「联系我」方式
      • 客户群「加入群聊」管理
        • 配置客户群进群方式
        • 获取客户群进群方式配置
        • 更新客户群进群方式配置
        • 删除客户群进群方式配置
    • 客户朋友圈
      • 客户朋友圈规则组管理
        • 客户朋友圈规则组管理-获取规则组列表
        • 客户朋友圈规则组管理-获取规则组详情
        • 客户朋友圈规则组管理-获取规则组管理范围
        • 客户朋友圈规则组管理-创建新的规则组
        • 客户朋友圈规则组管理-编辑规则组及其管理范围
        • 客户朋友圈规则组管理-删除规则组
  • 微信客服
    • 接待人员管理
      • 添加接待人员_v1
  • 家校沟通
    • 网页授权登录
      • 获取访问用户身份-企业内部开发
  • 应用管理
    • 自定义菜单
      • 创建菜单
      • 获取菜单
      • 删除菜单
    • 设置应用
      POST
  • 消息推送
    • 发送消息到群聊会话
      • 创建群聊会话
      • 修改群聊会话
      • 获取群聊会话
      • 应用推送消息
    • 互联企业消息推送
      • 发送应用消息
  • OA
    • 打卡
      • 获取企业所有打卡规则
      • 录入打卡人员人脸信息
    • 审批
      • 获取审批数据(旧)
    • 汇报
      • 批量获取汇报记录单号
      • 获取汇报记录详情
      • 获取汇报统计数据
    • 会议室
      • 会议室管理-添加会议室
      • 会议室管理-查询会议室
      • 会议室管理-编辑会议室
      • 会议室管理-删除会议室
      • 会议室预定管理 查询会议室的预定信息
      • 会议室预定管理 预定会议室
      • 会议室预定管理 取消预定会议室
    • 紧急通知应用
      • 发起语音电话
      • 获取接听状态
  • 效率工具
    • 微盘
      • 空间管理 新建空间
      • 空间管理 重命名空间
      • 空间管理 解散空间
      • 空间管理 获取空间信息
      • 空间权限 添加成员/部门
      • 空间权限 移除成员/部门
      • 空间权限 权限管理
      • 空间权限 获取邀请链接
      • 文件管理 获取文件列表
      • 文件管理 上传文件
      • 文件管理 下载文件
      • 文件管理 新建文件/微文档
      • 文件管理 重命名文件
      • 文件管理 移动文件
      • 文件管理 删除文件
      • 文件管理 文件信息
      • 文件权限 新增指定人
      • 文件权限 删除指定人
      • 文件权限 分享设置
      • 文件权限 获取分享链接
    • 公费电话
      • 获取公费电话拨打记录
  • 企业支付
    • 企业红包
      • 发放企业红包
      • 查询红包记录
    • 向员工付款
      • 向员工付款
      • 查询付款记录
    • 对外收款
      • 收款商户号管理 新增商户号
      • 收款商户号管理 查询商户号详情
      • 收款商户号管理 删除商户号
      • 收款商户号管理 设置商户号使用范围
  • 上下游
    • 获取上下游信息
      • 获取上下游列表
      • 获取上下游通讯录分组
      • 获取企业上下游通讯录分组下的企业详情列表
    • 获取下级/下游企业的access_token
    • 获取下级/下游企业小程序session
    • 上下游企业应用获取微信用户的external_userid
  • 会话内容存档
    • 获取会话内容
      • 获取会话内容 获取机器人信息
    • 获取会话内容存档开启成员列表
    • 获取会话同意情况 群聊请求
    • 获取会话同意情况 单聊请求
    • 获取会话内容存档内部群信息
  • 家校应用
    • 健康上报
      • 获取健康上报使用统计
      • 获取健康上报任务ID列表
      • 获取健康上报任务详情
      • 获取用户填写答案
    • 复学码
      • 获取老师健康信息
      • 获取学生健康信息
      • 获取师生健康码
  • 政民沟通
    • 配置网格结构
      • 添加网格
      • 编辑网格
      • 删除网格
      • 获取网格列表
      • 获取用户负责及参与的网格列表
    • 配置事件类别
      • 添加事件类别
      • 修改事件类别
      • 删除事件类别
      • 获取事件类别列表
    • 巡查上报
      • 获取配置的网格及网格负责人
      • 获取单位巡查上报数据统计
      • 获取个人巡查上报数据统计
      • 获取上报事件分类统计
      • 获取巡查上报事件列表
      • 获取巡查上报的事件详情信息
    • 居民上报
      • 获取配置的网格及网格负责人
      • 获取单位居民上报数据统计
      • 获取个人居民上报数据统计
      • 获取上报事件分类统计
      • 获取居民上报事件列表
      • 获取居民上报的事件详情信息
  1. 开发指南

获取access_token

GET
http://127.0.0.1/cgi-bin/gettoken
企业内部开发/开发指南
最后修改时间:2022-08-30 03:03:35
责任人:未设置
为了安全考虑,开发者请勿将access_token返回给前端,需要开发者保存在后台,所有访问企业微信api的请求由后台发起
获取access_token是调用企业微信API接口的第一步,相当于创建了一个登录凭证,其它的业务API接口,都需要依赖于access_token来鉴权调用者身份。
因此开发者,在使用业务接口前,要明确access_token的颁发来源,使用正确的access_token。
权限说明:
每个应用有独立的secret,获取到的access_token只能本应用使用,所以每个应用的access_token应该分开来获取。
注意事项:
开发者需要缓存access_token,用于后续接口的调用(注意:不能频繁调用gettoken接口,否则会受到频率拦截)。当access_token失效或过期时,需要重新获取。
access_token的有效期通过返回的expires_in来传达,正常情况下为7200秒(2小时),有效期内重复获取返回相同结果,过期后获取会返回新的access_token。
由于企业微信每个应用的access_token是彼此独立的,所以进行缓存时需要区分应用来进行存储。
access_token至少保留512字节的存储空间。
企业微信可能会出于运营需要,提前使access_token失效,开发者应实现access_token失效时重新获取的逻辑。

请求参数

Query 参数
corpid
string 
必需
企业ID,获取方式参考:术语说明-corpid
示例值:
ID
corpsecret
string 
必需
应用的凭证密钥,获取方式参考:术语说明-secret
示例值:
SECRET

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://127.0.0.1/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET'

返回响应

🟢200成功
application/json
Body
errcode
integer 
必需
出错返回码,为0表示成功,非0表示调用失败
errmsg
string 
返回码提示语
必需
access_token
string 
必需
获取到的凭证,最长为512字节
expires_in
integer 
必需
凭证的有效时间(秒)
示例
{
  "errcode": 0,
  "errmsg": "ok",
  "access_token": "accesstoken000001",
  "expires_in": 7200
}
上一页
概述
下一页
获取加入企业二维码
Built with