套餐升级续费

注意事项

- 大客户:支持延长有效期,开通外呼
- 非大客户下的主账户:支持延长有效期,开通外呼,增加子账户
- 升级续期的不考虑当前用户和上级用户的用户状态(正常,禁用,未激活,过期等等)

API路径

services/v2/rest/user/meal

请求header参数

字段 类型 说明 示例
x-ak-key string 当前分销的AK值  
x-ak-ts string 毫秒级时间戳
x-ak-pin string 经过加密算法生成的加密参数

请求参数

字段 类型 说明 必填
uid string 必须,此uid为第三方账户系统唯一用户编号 Y
expiry_time long 过期时间戳(毫秒级) N
type string 将要升级为新套餐的名称 N
  1. 只有uid为大客户和主账户的角色才可以升级续期

请求方法

PATCH

调用样例

https://${host}/services/v2/rest/user/meal

请求body

PATCH
 大客户下主账户升级续期请求结构
 {
      "uid":"5926cee5a600422292fd2676", 必须
      "extraTaskCount": 2000 //必须在任务已开的情况下续任务额度
      "type":"1+10工号",
 }

非大客户下主账户升级续期请求结构
{
"uid":"5926cee5a600422292fd2676",必须
"extraSubCount": 4,
"extraTaskCount": 2000 //必须在任务已开的情况下续任务额度
"type":"1+10工号",
"extraViewCount": 30
"expiry_time":1512536084000
}
  大客户升级续期请求结构
 {
      "uid":"5926cee5a600422292fd2676",必须
      "expiry_time":1512536084000,
 }

返回结果

JSON示例

大客户主和非大客户主 结果
{
  "error_code": 0,#表示续费成功
  "success":true
  "message": "",
  "data": {
    "agent_expiry_date": "1505699326580", // 分销过期时间
    "user_expiry_date": "1518969599000" // 用户续费后的过期时间
    "subaccount": 7 // 用户升级后子账户总数
    "enableCall": true // 用户升级后的外呼状态
    "enableTask": true // 用户升级后的任务中心状态
    "taskQuota": true // 用户升级后的任务中心额度
    "type": "1+10工号" // 用户升级后的套餐名称
  }
}
大客户结果
{
"error_code": 0,#表示续费成功
"success":true,
"message": "",
"data": {
"agent_expiry_date": "1505699326580", // 分销过期时间
"user_expiry_date": "1518969599000" // 用户续费后的过期时间
"enableCall": true // 用户升级后的外呼状态
}

返回错误代码以及处理方式

code 处理方式 说明
400 检查请求参数是否合法  
410 检查AK是否正确  
5027 检查账户状态是否有效或禁用  
5029 检查账户信息是否正确  
6102 检查uid是否注册过  
6110 检查用户角色是否是主账号或大客户 账户角色不正确
6115 检测套餐名称是否正确  
6116 检测套餐增值服务是否合法(赠送子账户,月数是否超限等)  
6117 子账户已经超过上限,无法增加  
6124 任务中心超过额度无法增加,无法增加  
6125 任务中心未开启  
文档更新时间: 2025-04-28 16:35   作者:姜河