直播交易分析

开发环境

GET

https://developer.toutiao.com/api/apps/v1/data_analysis/query_live_deal_data

获取小程序的直播交易分析数据。数据内容与“小程序控制台-运营-数据-交易分析-直播-历史直播/实时直播”页面里的交易数据保持一致。

使用限制

历史直播间：每日 14:00 前更新前一日数据

权限要求：服务商代调用场景下，需商家授予数据分析权限集。

错误码

错误码	描述	排查建议
-1	系统错误	建议重试
11001	appid无法解析	建议重试
11009	参数不合法或缺少参数	检查参数合法性
11016	access_token不正确或者已过期	检查access_token合法性
40006	非法请求，请求 IP 不在第三方小程序应用 IP 地址白名单内	添加IP地址到白名单内或者配置白名单为空
40036	授权小程序未授予该接口对应的权限	引导商家授予相关权限集

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://developer.toutiao.com/api/apps/v1/data_analysis/query_live_deal_data?live_room_id' \
--header 'access-token;'

响应示例

200 - 示例 1

{
  "err_no": 0,
  "err_msg": "string",
  "data": {
    "deal_overview_data": {
      "create_order_count": 0,
      "pay_order_count": 0,
      "create_order_amount": 0,
      "pay_order_amount": 0,
      "click_count": 0,
      "show_count": 0,
      "success_user_cnt": 0,
      "refund_order_cnt": 0,
      "sale_product_cnt": 0
    },
    "deal_data_list": [
      {
        "time": "string",
        "create_order_count": 0,
        "pay_order_count": 0,
        "create_order_amount": 0,
        "pay_order_amount": 0,
        "click_count": 0,
        "show_count": 0,
        "success_user_cnt": 0,
        "refund_order_cnt": 0,
        "sale_product_cnt": 0
      }
    ]
  }
}

请求参数

Query 参数

live_room_id

number

必需

直播间ID，可通过【获取直播房间数据】接口获取

Header 参数

access-token

string

必需

返回响应

🟢200成功

application/json

Body

err_no

integer

必需

err_msg

string

必需

data

object

必需

deal_overview_data

object

直播交易数据总览

必需

deal_data_list

array [object {10}]

必需

直播交易数据列表详情

🟠400请求有误

修改于 2023-12-07 02:37:53

直播数据分析

商品分析

直播交易分析

使用限制#

错误码#

请求参数

返回响应

使用限制

错误码