获取应用概况列表

来自企业号开发者接口文档
2015年5月24日 (日) 07:23Wikiadmin讨论 | 贡献的版本

跳转至: 导航搜索
  • 接口说明

该API 用于获取secret所在管理组内的应用概况,会返回管理组内应用的id及名称、头像等信息

  • 请求说明

Https请求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/agent/list?access_token=ACCESS_TOKEN

  • 参数说明
参数 必须 说明
access_token 调用接口凭证
  • 权限说明

该接口只返回调用管理组内的应用列表

  • 返回结果

如果无权限,则本次发送失败;如果收件人不存在或未关注,发送仍然执行,但返回无效的部分。

{
   "errcode": 0,
   "errmsg": "ok",
   "agentlist": [
       {
           "agentid": "5",
           "name": "企业小助手",
           "square_logo_url": "url",
           "round_logo_url": "url"
       },
       {
           "agentid": "8",
           "name": "HR小助手",
           "square_logo_url": "url",
           "round_logo_url": "url"
       }
       ]  
}


  • 参数说明
参数 说明
errcode 返回码
errmsg 返回码的文本描述内容
agentid 应用id
name 应用名称
square_logo_url 方形头像url
round_logo_url 圆形头像url