第三方应用开发 服务端API 接口调用许可 账号管理 激活账号
激活账号
最后更新:2024/01/31
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
激活账号
最后更新:2024/01/31

目录

  • 激活账号
  • 批量激活账号
  •  

    激活账号

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

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

    请求方式: 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 。

     

    返回结果:

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

    参数说明:

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

    批量激活账号

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

    1.一个userid允许激活一个基础账号以及一个互通账号。
    2. 若userid已激活,使用同类型的激活码来激活后,则绑定关系变为新激活码,新激活码有效时长自动叠加上旧激活码剩余时长,同时旧激活码失效。
    3. 为了避免服务商调用出错,多个同类型的激活码累加后的有效期不可超过5年,否则接口报错701030。
    4.为了避免服务商调用出错,只有当旧的激活码的剩余时长小于等于20天,才可以使用新的同类型的激活码进行激活并续期
    5. 单次激活的员工数量不超过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为成功
    上一篇
    使用余额支付订单
    下一篇
    获取激活码详情