获取企业永久授权码

该API用于使用临时授权码换取授权方的永久授权码,并换取授权信息、企业access_token,临时授权码一次有效。建议第三方以userid为主键,来建立自己的管理员账号。

请求方式:POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/service/get_permanent_code?suite_access_token=SUITE_ACCESS_TOKEN

请求包体:

{
    "auth_code": "auth_code_value"
}

参数说明:

参数 是否必须 说明
auth_code 临时授权码,会在授权成功时附加在redirect_uri中跳转回第三方服务商网站,或通过回调推送给服务商。长度为64至512个字节

返回结果:

{
    "errcode":0 ,
    "errmsg":"ok" ,
    "access_token": "xxxxxx", 
    "expires_in": 7200, 
    "permanent_code": "xxxx", 
    "dealer_corp_info": 
    {
        "corpid": "xxxx",
        "corp_name": "name"
    },
    "auth_corp_info": 
    {
        "corpid": "xxxx",
        "corp_name": "name",
        "corp_type": "verified",
        "corp_square_logo_url": "yyyyy",
        "corp_user_max": 50,
        "corp_agent_max": 30,
        "corp_full_name":"full_name",
        "verified_end_time":1431775834,
        "subject_type": 1,
        "corp_wxqrcode": "zzzzz",
        "corp_scale": "1-50人",
        "corp_industry": "IT服务",
        "corp_sub_industry": "计算机软件/硬件/信息服务",
        "location":"广东省广州市"
    },
    "auth_info":
    {
        "agent" :
        [
            {
                "agentid":1,
                "name":"NAME",
                "round_logo_url":"xxxxxx",
                "square_logo_url":"yyyyyy",
                "appid":1,
                "privilege":
                {
                    "level":1,
                    "allow_party":[1,2,3],
                    "allow_user":["zhansan","lisi"],
                    "allow_tag":[1,2,3],
                    "extra_party":[4,5,6],
                    "extra_user":["wangwu"],
                    "extra_tag":[4,5,6]
                }
            },
            {
                "agentid":2,
                "name":"NAME2",
                "round_logo_url":"xxxxxx",
                "square_logo_url":"yyyyyy",
                "appid":5
            }
        ]
    },
    "auth_user_info":
    {
        "userid":"aa",
        "name":"xxx",
        "avatar":"http://xxx"
    },
    "register_code_info":
    {
        "register_code":"1111",
        "template_id":"tpl111",
        "state":"state001"
    }
}

参数说明:

参数 说明
access_token 授权方(企业)access_token,最长为512字节
expires_in 授权方(企业)access_token超时时间
permanent_code 企业微信永久授权码,最长为512字节
auth_corp_info 授权方企业信息
corpid 授权方企业微信id
corp_name 授权方企业名称,即企业简称
corp_type 授权方企业类型,认证号:verified, 注册号:unverified
corp_square_logo_url 授权方企业方形头像
corp_user_max 授权方企业用户规模
corp_agent_max 授权方企业应用数上限
corp_full_name 授权方企业的主体名称(仅认证或验证过的企业有),即企业全称。
subject_type 企业类型,1. 企业; 2. 政府以及事业单位; 3. 其他组织, 4.团队号
verified_end_time 认证到期时间
corp_wxqrcode 授权企业在微工作台(原企业号)的二维码,可用于关注微工作台
corp_scale 企业规模。当企业未设置该属性时,值为空
corp_industry 企业所属行业。当企业未设置该属性时,值为空
corp_sub_industry 企业所属子行业。当企业未设置该属性时,值为空
location 企业所在地信息, 为空时表示未知
auth_info 授权信息。如果是通讯录应用,且没开启实体应用,是没有该项的。通讯录应用拥有企业通讯录的全部信息读写权限
agent 授权的应用信息,注意是一个数组,但仅旧的多应用套件授权时会返回多个agent,对新的单应用授权,永远只返回一个agent
agentid 授权方应用id
name 授权方应用名字
square_logo_url 授权方应用方形头像
round_logo_url 授权方应用圆形头像
appid 旧的多应用套件中的对应应用id,新开发者请忽略
privilege 应用对应的权限
allow_party 应用可见范围(部门)
allow_tag 应用可见范围(标签)
allow_user 应用可见范围(成员)
extra_party 额外通讯录(部门)
extra_user 额外通讯录(成员)
extra_tag 额外通讯录(标签)
level 权限等级。
1:通讯录基本信息只读
2:通讯录全部信息只读
3:通讯录全部信息读写
4:单个基本信息只读
5:通讯录全部信息只写
auth_user_info 授权管理员的信息
userid 授权管理员的userid,可能为空(内部管理员一定有,不可更改)
name 授权管理员的name,可能为空(内部管理员一定有,不可更改)
avatar 授权管理员的头像url
dealer_corp_info 代理服务商企业信息
dealer_corp_info.corpid 代理服务商企业微信id
dealer_corp_info.corp_name 代理服务商企业微信名称
register_code_info 推广二维码安装相关信息,扫推广二维码安装,且安装时创建全新企业时才返回
register_code 注册码
template_id 推广包ID
state 仅当获取注册码指定该字段时才返回
© 1998 - 2020 Tencent Inc. All Rights Reserved