三方厂商通用上报

联调中

正式环境

https://api.kg.qq.com

POST

/karaoke/report/v2/third_party_report

需要与产品沟通获取上报key，具体除了key与上报时间外，其他字段与产品协商填写。

字段定义：https://doc.weixin.qq.com/sheet/e3_AdgAlQYsAGUCNP6YpMA18SnyD6AXf?scode=AJEAIQdfAAo4p0J2OgAdgAlQYsAGU

请求参数

Header 参数

Body 参数application/json

示例

{
  "key": "testkey",
  "data": {
    "ftime": 20251202,
    "channel_name": "K",
    "songid": "003OiWx80je1zU",
    "song_name": "时差(Live)",
    "singer_name": "魏翔",
    "order_num": 28,
    "open_source": "搜索",
    "open_type": "首开",
    "amount": 1900,
    "duration": 31,
    "goods_name": "月卡",
    "order_id": "109275_2",
    "remark": "普通toc会员",
    "trantime": 1733123456,
    "user_id": "13800138000",
    "openid": "abc123xyz789",
    "uid": 888888,
    "order_status": 0,
    "device_info": "华为Mate100Pro",
    "imei": "860000000000001",
    "status": 2,
    "app_version": "3.2.1",
    "opertime": "1733123456",
    "from_page": "toplist_1",
    "play_mode": 1,
    "pay_type": 1,
    "stage_id": "990909652255133696"
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.kg.qq.com/karaoke/report/v2/third_party_report' \
--header 'X-Open-Access-Token: ' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID: ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "key": "testkey",
  "data": {
    "ftime": 20251202,
    "channel_name": "K",
    "songid": "003OiWx80je1zU",
    "song_name": "时差(Live)",
    "singer_name": "魏翔",
    "order_num": 28,
    "open_source": "搜索",
    "open_type": "首开",
    "amount": 1900,
    "duration": 31,
    "goods_name": "月卡",
    "order_id": "109275_2",
    "remark": "普通toc会员",
    "trantime": 1733123456,
    "user_id": "13800138000",
    "openid": "abc123xyz789",
    "uid": 888888,
    "order_status": 0,
    "device_info": "华为Mate100Pro",
    "imei": "860000000000001",
    "status": 2,
    "app_version": "3.2.1",
    "opertime": "1733123456",
    "from_page": "toplist_1",
    "play_mode": 1,
    "pay_type": 1,
    "stage_id": "990909652255133696"
  }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "sub_code": 0,
    "msg": "请求成功",
    "data": {
        "result": 0
    }
}

修改于 2026-01-19 09:10:47

获取kg的短链接

KtvSdk4.0接入文档