获取企业号应用

来自企业号开发者接口文档
跳转至: 导航搜索
  • 接口说明

该API用于获取企业号某个应用的基本信息,包括头像、昵称、帐号类型、认证类型、可见范围等信息

  • 请求说明

Https请求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/agent/get?access_token=ACCESS_TOKEN&agentid=AGENTID

  • 参数说明
参数 说明
access_token 调用接口凭证
agentid 企业应用的id
  • 权限说明

管理组须拥有指定应用的发消息权限。

  • 返回说明
{
   "errcode":"0",
   "errmsg":"ok" ,
   "agentid":"1" ,
   "name":"NAME" ,
   "square_logo_url":"xxxxxxxx" ,
   "round_logo_url":"yyyyyyyy" ,
   "description":"desc" ,
   "allow_userinfos":{
       "user":[
             {
                 "userid":"id1",
                 "status":"1"
             },
             {
                 "userid":"id2",
                 "status":"1"
             },
             {
                 "userid":"id3",
                 "status":"1"
             }
              ]
    },
   "allow_partys":{
       "partyid": [1]
    },
   "allow_tags":{
       "tagid": [1,2,3]
    }
   "close":0 ,
   "redirect_domain":"www.qq.com",
   "report_location_flag":0,
   "isreportuser":0,
   "isreportenter":0,
   "chat_extension_url":"http://www.qq.com",
   "type":1
}
参数 说明
agentid 企业应用id
name 企业应用名称
square_logo_url 企业应用方形头像
round_logo_url 企业应用圆形头像
description 企业应用详情
allow_userinfos 企业应用可见范围(人员),其中包括userid和关注状态state
allow_partys 企业应用可见范围(部门)
allow_tags 企业应用可见范围(标签)
close 企业应用是否被禁用
redirect_domain 企业应用可信域名
report_location_flag 企业应用是否打开地理位置上报 0:不上报;1:进入会话上报;2:持续上报
isreportuser 是否接收用户变更通知。0:不接收;1:接收
isreportenter 是否上报用户进入应用事件。0:不接收;1:接收
type 应用类型。1:消息型;2:主页型
chat_extension_url 关联会话url