Sign in
Web TurboLink

TurboLink Web 奖品发放回调

TurboLink 服务端在用户完成任务后回调本接口，为用户发放 Bonus 奖励。无需登录、无需 FlexTV 接口签名。鉴权方式：请求头 Authorization 固定为 Token {NOTIFY_TOKEN}，其中 NOTIFY_TOKEN 来自环境变量 TURBOLINK.NOTIFY_TOKEN。user_id 必须传 public_uid（HashId），不能传数字 uid。奖励金额从 kv_data 中解析，优先识别 SEO_Bonus、reward、bonus、Bonus，或 key 名包含 bonus 的字段；也可仅传 reward_num。成功返回纯文本 success，失败返回纯文本 fail（HTTP 均为 200）。

响应契约：TurbolinkWebCallbackText。

鉴权失败、body 非法、用户不存在、奖励金额<=0 或发奖失败时返回 fail。相同 task_id 重复回调时幂等返回 success。

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

认证要求：无需登录。

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

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

post/turbolink/webCallback

Headers

Authorizationstring required

鉴权头，格式：Token {NOTIFY_TOKEN}。

鉴权头，格式：Token {NOTIFY_TOKEN}。

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。

task_idstring

任务/活动唯一 ID，用于幂等去重。

reward_numinteger

奖励倍数，默认 1。

user_platformstring

用户平台，如 web、web-pc、android、ios。

kv_dataobject

奖励配置，如 reward 或 SEO_Bonus 字段。

Response

请求成功

codeinteger required
msgstring required
data'success' | 'fail' required

奖品发放回调结果纯文本。注意：webCallback 实际 HTTP Body 为纯文本 success 或 fail，不经过标准 JSON 包装；此处为 data 字段语义说明。

infoobject required
is_encrypt0 | 1 required
request_idstring required
response_timeinteger required
original_dataobject

Example response

{
  "msg": "成功",
  "data": "success"
}

Changes

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