/ 
QQ-weixin-work-0.04
River stage zero No dependents
/ QQ::weixin::work::agent

Name

QQ::weixin::work::agent

DESCRIPTION

应用管理

FUNCTION

get(access_token,agentid);

获取指定的应用详情

SYNOPSIS

https://work.weixin.qq.com/api/doc/90000/90135/90227

请求说明：

参数说明：

参数	            必须	说明
access_token	是	调用接口凭证
agentid	是	应用id

权限说明：

企业仅可获取当前凭证对应的应用；第三方仅可获取被授权的应用。

RETURN 返回结果：

{
	"errcode": 0,
	"errmsg": "ok",
  "agentid": 1000005,
  "name": "HR助手",
  "square_logo_url":  "https://p.qlogo.cn/bizmail/FicwmI50icF8GH9ib7rUAYR5kicLTgP265naVFQKnleqSlRhiaBx7QA9u7Q/0",
  "description": "HR服务与员工自助平台",
  "allow_userinfos": {
    "user": [
         {"userid": "zhangshan"},
         {"userid": "lisi"}
         ]
       },
  "allow_partys": {
   "partyid": [1]
 },
 "allow_tags": {
   "tagid": [1,2,3]
 },
 "close": 0,
 "redirect_domain": "open.work.weixin.qq.com",
 "report_location_flag": 0,
 "isreportenter": 0,
 "home_url": "https://open.work.weixin.qq.com"
}

RETURN 参数说明：

参数	        说明
errcode	    出错返回码，为0表示成功，非0表示调用失败
errmsg	返回码提示语
agentid	企业应用id
name	企业应用名称
square_logo_url	企业应用方形头像
description	企业应用详情
allow_userinfos	企业应用可见范围（人员），其中包括userid
allow_partys	企业应用可见范围（部门）
allow_tags	企业应用可见范围（标签）
close	企业应用是否被停用
redirect_domain	企业应用可信域名
report_location_flag	企业应用是否打开地理位置上报 0：不上报；1：进入会话上报；
isreportenter	是否上报用户进入应用事件。0：不接收；1：接收
home_url	应用主页url

list(access_token);

获取access_token对应的应用列表

SYNOPSIS

https://work.weixin.qq.com/api/doc/90000/90135/90227

请求说明：

参数说明：

参数	            必须	说明
access_token	是	调用接口凭证

权限说明：

企业仅可获取当前凭证对应的应用；第三方仅可获取被授权的应用。

RETURN 返回结果：

{
	"errcode": 0,
	"errmsg": "ok",
  "agentlist":[
      {
          "agentid": 1000005,
          "name": "HR助手",
          "square_logo_url": "https://p.qlogo.cn/bizmail/FicwmI50icF8GH9ib7rUAYR5kicLTgP265naVFQKnleqSlRhiaBx7QA9u7Q/0"
      }
  ]
}

RETURN 参数说明：

参数	        说明
errcode	    出错返回码，为0表示成功，非0表示调用失败
errmsg	返回码提示语
agentlist	AgentItemArray	当前凭证可访问的应用列表

AgentItem 结构：

参数	类型	说明
agentid	Integer	企业应用id
name	String	企业应用名称
square_logo_url	String	企业应用方形头像url

set(access_token, hash);

设置应用

SYNOPSIS

https://work.weixin.qq.com/api/doc/90000/90135/90228

请求说明：

请求包结构体为：

{
  "agentid": 1000005,
  "report_location_flag": 0,
  "logo_mediaid": "j5Y8X5yocspvBHcgXMSS6z1Cn9RQKREEJr4ecgLHi4YHOYP-plvom-yD9zNI0vEl",
  "name": "财经助手",
  "description": "内部财经服务平台",
  "redirect_domain": "open.work.weixin.qq.com",
  "isreportenter": 0,
  "home_url": "https://open.work.weixin.qq.com"
}

参数说明：

参数	必须	说明
access_token	是	调用接口凭证
agentid	是	企业应用的id
report_location_flag	否	企业应用是否打开地理位置上报 0：不上报；1：进入会话上报；
logo_mediaid	否	企业应用头像的mediaid，通过素材管理接口上传图片获得mediaid，上传后会自动裁剪成方形和圆形两个头像
name	否	企业应用名称，长度不超过32个utf8字符
description	否	企业应用详情，长度为4至120个utf8字符
redirect_domain	否	企业应用可信域名。注意：域名需通过所有权校验，否则jssdk功能将受限，此时返回错误码85005
isreportenter	否	是否上报用户进入应用事件。0：不接收；1：接收。
home_url	否	应用主页url。url必须以http或者https开头（为了提高安全性，建议使用https）。

权限说明

仅企业可调用，可设置当前凭证对应的应用；第三方不可调用。

RETURN 返回结果

{
	"errcode": 0,
	"errmsg": "ok"
}

RETURN 参数说明

参数	    说明
errcode	返回码
errmsg	对返回码的文本描述内容