You need to enable JavaScript to run this app.
最新活动
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们
导航

获取直播预约信息

最近更新时间2023.06.07 15:55:43

首次发布时间2023.02.01 10:13:24

获取直播间的直播预约信息。

说明

企业直播新增渠道推广功能,支持创建不同的渠道。有关如何创建渠道,详见渠道推广。对于使用了渠道推广功能的直播间,请调用本接口获取不同渠道的数据信息。如果您未使用渠道推广功能,请调用 GetActivityReservationAPI 接口获取直播预约信息。

请求说明

  • 接口名称:GetActivityReservationAPIV2
  • 请求方式:GET
  • 接口地址:http://livesaas.volcengineapi.com/?Action=GetActivityReservationAPIV2&Version=2020-06-01
  • 请求频率:单用户请求频率限制为 120 次/分钟

请求参数

以下请求参数列表仅列出了该接口的部分公共参数,完整公共参数列表见公共请求参数

Query

参数

类型

是否必选

描述

Action

String

接口名称。

Version

String

接口版本。直播当前 API 的版本为 2020-06-01。

ActivityId

Int

直播间 ID。您可以通过调用 ListActivityAPI 接口查询 ID。

Page

Int

分页查询页码,默认值为 1

PageSize

Int

分页查询数量,默认值为 10

Channel

String

根据渠道标识进行筛选。您可以通过调用 ListChannelAPI 接口查询渠道标识,默认查询全部渠道数据。

TelReserve

String

预约手机号。

返回参数

参数

类型

描述

ActivityId

Int64

直播间 ID。

Total

Int

查询结果总数。

Page

Int

查询结果页数。

Items

Array of ActivityReservation

直播预约信息。

ActivityReservation

参数

类型

描述

NickName

String

昵称。

TelReserve

String

预留手机号。

IP

String

IP 地址。

IpAddress

String

IP 地址所在地区。

SubmitTime

Int

提交直播预约的时间。

UserDevice

String

终端类型。

ExternalId

String

观众在第三方平台的唯一标识。您可以根据该关联用户 ID 识别企业自身的用户身份,以便于按需实现用户洞察和进行数据分析。观众通过不同方式登录直播间时,关联用户 ID 取值不同,具体取值情况详见数据统计

Extra

String

业务方扩展参数。

Channel

String

渠道标识。

UserId

Int

用户 ID。

示例

请求示例

Get http://livesaas.volcengineapi.com/?Action=GetActivityReservationAPIV2&Version=2020-06-01&Page=1&PageSize=10&ActivityId=12311&Channel=1&TelReserve=13718780036

正常返回示例

{ 
      "ResponseMetadata": { 
          "RequestId": "20220622192459010*****", 
        "Action": "GetActivityReservationAPIV2", 
        "Version": "2020-06-01", 
        "Service": "livesaas", 
        "Region": "cn-north-1", 
        "SystemTime": 1655897099 
      }, 
    "Result": { 
          "ActivityId": 12311, 
        "Total": 71, 
        "Page": 1, 
        "Items": [ 
            { 
                "NickName": "Cat", 
                "TelReserve": "137***36", 
                "IP": "2408:8207:3c28:1bb0:4940:d718:f8", 
                "IpAddress": "北京", 
                "SubmitTime": 16***422, 
                "UserDevice": "Android 12", 
                "ExternalId": "54211", 
                "Extra": "", 
                "Channel": "1", 
                "UserId": 31749773402 
              }
          ]
      }
}
        

异常返回示例

{
    "ResponseMetadata":{
        "RequestId":"201806041104200100100232280022D30",
        "Action":"GetActivityReservationAPIV2",
        "Version":"2020-06-01",
        "Service":"livesaas",
        "Region":"cn-north-1",
        "SystemTime":1656067132,
        "Error":{
            "Code":"200000",
            "Message":"参数异常" 
        }
    }
}

错误码

访问公共错误码获取详细信息。