第三方应用开发 服务端API 账号ID 获取接口大批量调用凭据
获取接口大批量调用凭据
最后更新:2024/03/11
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取接口大批量调用凭据
最后更新:2024/03/11

目录

  • 获取接口高频调用凭据
  • 凭据使用示例
  • 应用被授权安装后,往往需要为企业进行较大规模的数据初始化,而企业微信的ID转换等接口会有较为严格的业务频率限制,短时间内难以完成初始化。

    因此,企业微信允许服务商在企业授权后3个月内申请一个高频调用凭据,调用相关接口时传入该凭据,可以不受业务频率限制(但依然受到基础频率限制)。

    目前仅以下接口支持高频调用凭据

    unionid转换为第三方external_userid
    unionid转换为上下游external_userid

     

    获取接口高频调用凭据

    请求方式:GET(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/corp/apply_mass_call_ticket?access_token=ACCESS_TOKEN

    请求参数:

    参数说明:

    参数必须说明
    access_token调用接口凭证 ,根据应用场景目前支持下列应用:
    - 第三方应用access_token代开发应用access_token
    - 上下游自建或代开发应用的上游应用access_token

     

    权限说明:

    仅限授权三个月内的企业获取,且每个企业最多仅能获取一次
    该凭据获取成功后,有效期为7天,请在7天内完成企业的初始化操作
    使用该凭据可以不受业务频率限制,但是依然受到基础频率限制

    返回结果:

    
     "errcode":0,
     "errmsg":"ok",
     "mass_call_ticket":"AAAAAA"
    

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    mass_call_ticket大批量调用凭据

    凭据使用示例

    unionid转换为第三方external_userid为例,在请求中加入mass_call_ticket字段即可:

    请求方式:POST(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/idconvert/unionid_to_external_userid?access_token=ACCESS_TOKEN

    请求参数:

    {
      "unionid":"oAAAAAAA",
      "openid":"oBBBB",
      "subject_type":1,
      "mass_call_ticket":"TICKET"
    }

    参数说明:

    参数必须说明
    access_token调用接口凭证 ,第三方应用access_token代开发应用access_token
    unionid微信客户的unionid
    openid微信客户的openid
    subject_type小程序或公众号的主体类型:
    0表示主体名称是企业的,
    1表示主体名称是服务商的
    mass_call_ticket大批量调用凭据
    上一篇
    ID迁移完成状态的设置
    下一篇
    概述