授权设备体验会员

联调中

正式环境

https://api.kg.qq.com

POST

/karaoke/payment/v2/grant_device_exp_vip

支付类

会员用户给设备授权使用体验会员。
授权规则：

同一用户同一时间，只能给一台设备授权会员权益。如果授权了新的设备，则默认踢除旧设备使用权益。

单次授权时长最长6小时，会员结束时间需要大于授权结束时间。

同一设备同一时间仅能被一个用户授权

错误码：
50305 用户会员时长不符合条件，会员结束时间需要大于授权结束时间。
50306 重复授权，设备已被其他用户授权

请求参数

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

data

string

必需

GrantInfo json字符串, 并经base64编码。
GrantInfo 结构为：

参数名	必选	类型	说明	备注
openid	是	string	用户id	开放平台用户账号，需要是会员用户
device_id	是	string	设备id	必须从SDK获取
grant_hour	是	int	授权时长	单位小时最大6
sign_time	是	int	签名时间戳	单位秒

sign

string

必需

对data字段的签名，签名规则参考：https://apifox.com/apidoc/project-951819/doc-771666

示例

{
    "data": "string",
    "sign": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.kg.qq.com/karaoke/payment/v2/grant_device_exp_vip' \
--header 'X-Open-Access-Token;' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID;' \
--header 'Device-ID;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": "string",
    "sign": "string"
}'

返回响应

🟢200成功

application/json

Body

expire_in

integer

必需

授权有效时长，单位秒

示例

{
    "expire_in": 0
}

【三方支付】存量会员迁移接口

查询用户会员信息