Web TurboLink

TurboLink Web 积分扣减/兑换回调

TurboLink 活动内积分扣减或兑换时回调本接口。无需登录、无需 FlexTV 接口签名。鉴权方式:Authorization 为 Token 或 Bearer + 签名,签名算法 md5(OPEN_SECRET + ' ' + md5(原始请求体)),OPEN_SECRET 来自环境变量 TURBOLINK.OPEN_SECRET。state=deduct 时扣减 Bonus;state=gain 时发放 Bonus。user_id 必须传 public_uid。

响应契约:TurbolinkWebDeductBonus。

鉴权失败返回 code=401;业务失败(余额不足、用户不存在等)返回 code=200 且 state=lack。幂等重复请求返回 state=success。

路由声明:服务端允许任意 HTTP 方法访问,文档以 POST 形式展示。

认证要求:无需登录。

签名要求:无需请求签名。

响应处理:返回明文响应。

post/turbolink/webDeductBonus

Headers

Authorizationstring required

鉴权头,格式:Bearer {sign} 或 Token {sign},sign=md5(OPEN_SECRET + ' ' + md5(body))。

鉴权头,格式:Bearer {sign} 或 Token {sign},sign=md5(OPEN_SECRET + ' ' + md5(body))。

Content-Typestring required

固定为 application/json。

固定为 application/json。

langstring

语言代码,例如 en、zh、es。

语言代码,例如 en、zh、es。

device_numberstring

设备唯一标识。

设备唯一标识。

app_versionstring

客户端版本号。

客户端版本号。

Request body

user_idstring required

用户 public_uid。

statestring required

操作类型:deduct=扣减积分,gain=发放积分。

numinteger required

积分数量,必须大于 0。

deduct_idstring

扣减幂等 ID,state=deduct 时建议传入。

gain_idstring

发放幂等 ID,state=gain 时建议传入。

user_platformstring

用户平台,如 web、web-pc。

Response

请求成功

codeinteger required
msgstring required
infoobject required
is_encrypt0 | 1 required
request_idstring required
response_timeinteger required
original_dataobject

Example response

{
  "msg": "成功"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.