20.4.1 获取应用
该API用于获取企业号某个应用的基本信息,包括头像、昵称、账号类型、认证类型、可见范围等信息。
获取应用的接口如下。
https:// qyapi.weixin.qq.com/cgi-bin/agent/get?access_token=ACCESS_TOKEN&agentid=AGENTID
上述接口的参数说明如表20-17所示。
表20-17 获取应用接口的参数说明
正确提交时,返回的数据示例如下。
{
"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
}
上述数据的参数说明如表20-18所示。
表20-18 获取应用接口返回参数说明