获取企业授权信息

POST

/cgi-bin/service/get_auth_info

服务端API智慧硬件开发第三方应用开发

该API用于通过永久授权码换取企业微信的授权信息。永久code的获取，是通过临时授权码使用get_permanent_code 接口获取到的permanent_code。

注意：因历史原因，该接口在调用失败时才返回errcode。没返回errcode视为调用成功

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/service/get_auth_info?suite_access_token=suite_access_token' \
--header 'Content-Type: application/json' \
--data-raw '{"auth_corpid":"auth_corpid_value","permanent_code":"code_value"}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "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_full_name": "full_name",
    "verified_end_time": 1431775834,
    "subject_type": 1,
    "corp_wxqrcode": "zzzzz",
    "corp_scale": "1-50人",
    "corp_industry": "IT服务",
    "corp_sub_industry": "计算机软件/硬件/信息服务"
  },
  "auth_info": {
    "agent": [
      {
        "agentid": 1,
        "name": "NAME",
        "round_logo_url": "xxxxxx",
        "square_logo_url": "yyyyyy",
        "appid": 1,
        "auth_mode": 1,
        "is_customized_app": false,
        "auth_from_thirdapp": false,
        "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
          ]
        },
        "shared_from": {
          "corpid": "wwyyyyy",
          "share_type": 1
        }
      },
      {
        "agentid": 2,
        "name": "NAME2",
        "round_logo_url": "xxxxxx",
        "square_logo_url": "yyyyyy",
        "appid": 5,
        "shared_from": {
          "corpid": "wwyyyyy",
          "share_type": 0
        }
      }
    ]
  }
}

请求参数

Query 参数

suite_access_token

必需

示例值:

suite_access_token

Body 参数application/json

auth_corpid

string

授权方corpid

必需

permanent_code

string

必需

永久授权码，通过get_permanent_code获取

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

dealer_corp_info

object

必需

代理服务商企业信息

corpid

string

必需

代理服务商企业微信id

corp_name

string

必需

代理服务商企业微信名称

auth_corp_info

object

授权方企业信息

必需

corpid

string

授权方企业微信id

必需

corp_name

string

授权方企业名称

必需

corp_type

string

必需

授权方企业类型，认证号：verified, 注册号：unverified

corp_square_logo_url

string

授权方企业方形头像

必需

corp_user_max

integer

授权方企业用户规模

必需

corp_full_name

string

必需

授权方企业的主体名称(仅认证或验证过的企业有)，即企业全称。企业微信将逐步回收该字段，后续实际返回内容为企业名称，即auth_corp_info.corp_name。

verified_end_time

integer

认证到期时间

必需

subject_type

integer

必需

企业类型，1. 企业; 2. 政府以及事业单位; 3. 其他组织, 4.团队号

corp_wxqrcode

string

必需

授权企业在微信插件（原企业号）的二维码，可用于关注微信插件，二维码有效期为7天

corp_scale

string

必需

企业规模。当企业未设置该属性时，值为空

corp_industry

string

必需

企业所属行业。当企业未设置该属性时，值为空

corp_sub_industry

string

必需

企业所属子行业。当企业未设置该属性时，值为空

auth_info

object

必需

授权信息。如果是通讯录应用，且没开启实体应用，是没有该项的。通讯录应用拥有企业通讯录的全部信息读写权限

agent

array [object {10}]

必需

授权的应用信息，注意是一个数组，但仅旧的多应用套件授权时会返回多个agent，对新的单应用授权，永远只返回一个agent

修改于 2022-12-05 04:13:03

获取企业永久授权码

获取企业凭证