第三方应用开发 服务端API 接口调用许可 帐号管理 激活帐号
激活帐号

目录

  • 激活帐号
  • 批量激活帐号
  •  

    激活帐号

    下单购买帐号并支付完成之后,先调用获取订单中的帐号列表接口获取到帐号激活码,然后可以调用该接口将激活码绑定到某个企业员工,以对其激活相应的平台服务能力。

    1. 一个userid允许激活一个基础帐号以及一个互通帐号。
    2. 若userid已激活,使用同类型的激活码来激活后,则绑定关系变为新激活码,新激活码有效时长自动叠加上旧激活码剩余时长,同时旧激活码失效。
    3. 为了避免服务商调用出错,多个同类型的激活码累加后的有效期不可超过5年,否则接口报错701030。

    请求方式: POST(HTTPS
    请求地址: https://qyapi.weixin.qq.com/cgi-bin/license/active_account?provider_access_token=ACCESS_TOKEN

    请求包体:

    {
    	"active_code" : "XXXXXXXX",
    	"corpid": "CORPID",
    	"userid": "USERID"
    }

    参数说明:

    参数是否必须说明
    provider_access_token应用服务商的接口调用凭证,获取方法参见服务商的凭证
    active_code帐号激活码
    corpid激活码所属企业corpid
    userid待绑定激活的企业成员userid 。只支持加密的userid

     

    返回结果:

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

    参数说明:

    参数说明
    errcode错误码
    errmsg错误码说明

    批量激活帐号

    可在一次请求里为一个企业的多个成员激活许可帐号,便于服务商批量化处理。

    1.一个userid允许激活一个基础帐号以及一个互通帐号。
    2.若userid已激活,使用一个新的激活码来激活,会将原来userid绑定的激活码失效,若原激活码仍然有效,则将剩余的有效期天数累加到当前新的激活码上。累加后的有有效期不超过5年,否则接口报错701030。
    3. 单次激活的员工数量不超过1000

    请求方式: POST(HTTPS
    请求地址: https://qyapi.weixin.qq.com/cgi-bin/license/batch_active_account?provider_access_token=ACCESS_TOKEN

    请求包体:

    {
    	"corpid": "CORPID",
    	"active_list":[
    	{
    		"active_code" : "XXXXXXXX",
    		"userid": "USERID"
    	},
    	{
    		"active_code" : "XXXXXXXX",
    		"userid": "USERID"
    	}]
    }

    参数说明:

    参数是否必须说明
    provider_access_token应用服务商的接口调用凭证,获取方法参见服务商的凭证
    corpid激活码所属企业corpid
    active_list需要激活的帐号列表
    active_list.active_code帐号激活码
    active_list.userid待绑定激活的企业成员userid

    返回结果:

    {
    	"errcode": 0,
    	"errmsg": "ok",
    	"active_result":[
    	{
    		"active_code" : "XXXXXXXX",
    		"userid": "USERID",
    		"errcode":0
    	},
    	{
    		"active_code" : "XXXXXXXX",
    		"userid": "USERID",
    		"errcode":0
    	}]
    }

    参数说明:

    参数说明 
    errcode错误码 
    errmsg错误码说明 
    active_result激活结果列表
    active_result.active_code帐号激活码
    active_result.userid本次激活的企业成员的加密userid
    active_result.errcode用户激活错误码,0为成功
    上一篇
    获取订单中的帐号列表
    下一篇
    获取激活码详情