【CDK】CDK兑换

正式环境

POST

/karaoke/spec/v2/exchange_cdkey

支付类用户级鉴权

使用cdkey码兑换会员。
1、请优先判断code，具体code说明参考，根目录-业务错误码说明
2、当code=50503情况下，可以继续判断sub_code。其余情况下，无需关注sub_code值
sub_code错误码说明：若需要同步兑换结果，可以联系K歌同学配置回调地址。

错误码错误原因
-10 CDK已兑换
-13 CDK错误。通常是CDK不存在，输入有误
-20 兑换超过活动日限
-21 兑换超过活动周限
-22 兑换超过活动月限
 -23 兑换超过活动总限
-8004 CDK已过期
-9001 CDK已兑换
-9003 CDK已禁止兑换（发生了退款，cdk已被召回）
-9004 兑换渠道不允许
-9005 账号错误
-9006 服务繁忙，请稍后再试（兑换频率过快）
-9100 兑换失败。请联系K歌同学进行定位
-9101 兑换次数超过活动日限
-9102 兑换超过活动周限
-9103 兑换次数超过用户次数限制
-10003 参数错误。通常是CDK错误，例如长度不对
-9999 CDK不存在。通常是CDK错误

请求参数

Header 参数

X-Open-Access-Token

string

必需

access token

默认值:

X-Open-ID

string

openid

可选

默认值:

X-Open-App-ID

string

业务appid

必需

默认值:

Device-ID

string

可选

设备id，调用KtvSdk.getSdkImei()获取

Body 参数application/json

cdkey

string

cdk码

可选

示例

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.kg.qq.com/karaoke/spec/v2/exchange_cdkey?members&reference&Type&_postman_listIndexKey=key&_postman_listAllowsMultipleValues' \
--data-raw ''

返回响应

🟢200OK

application/json

Body

days

integer

兑换成功天数

可选

rest_day

integer

剩余未兑换天数

可选

示例

{
  "days": 0,
  "rest_day": 0
}

修改于 2024-07-03 09:37:51

通用sign计算规则

【CDK】生成CDK