Get Play Statistics History Info

Last updated: 2018-07-10 17:05:16

    1. API Description

    • API
      This API (Get_LivePlayStatHistory) is used to obtain the historical statistics of playback.
    • URL
      URL for calling API: http://statcgi.video.qcloud.com/common_access
    • Note
      • Used to obtain the playback information for specified time period.
      • The playback statistics is updated every 1 minute.
      • This API supports LVB code mode and channel mode.
      • Backend configuration is required to use the API. To call the API, contact Tencent service personnel or submit a ticket. Tel: 4009-100-100.

    2. Input Parameters

    Parameter Name Description Type Note Required
    cmd Business ID int The LVB appid, which is used to identify different customers Y
    interface API name string Y
    t Expiration timestamp int Y
    sign Signature string md5 (key+expiration timestamp) Y
    Param.n.start_time Start time for the query int Limited to the last 15 days from the timestamp Y
    Param.n.end_time End time int It is recommended to limit the timestamp between start and end times to 2 hours Y
    Param.s.stream_id Steam ID string If it is left empty, the total bandwidth is obtained N
    Param.s.domain Domain name String If it is left empty, all the data under the APPID is obtained. The original playback domain name before cname is required N

    3. Output Parameters

    Parameter Name Description Type Remarks Note
    ret Error code int 0: Successful; other values: Failed.
    message Error message string Error message
    output Message content array For more information, please see the description below. -

    "output" is composed as follows:

    Parameter Name Description Type Remarks Note
    stat_info Statistics for the LVB stream array
    sum_info Traffic and summation information array Required output parameter
    domain Domain Name string Optional output parameter
    stream_id Steam ID string Optional output parameter

    "stat_info" is composed as follows:

    Parameter Name Description Type Remarks Note
    time Statistical time string
    bandwidth Bandwidth double In Mbps
    online Number of online users int
    flux Traffic double In MB

    "sum_info" (summary) is composed as follows:

    Parameter Name Description Type Remarks Note
    sum_flux Traffic summation double Required output parameter In MB

    4. Example

    Purpose: To query the list of files recorded during the LVB for the LVB stream with an LVB Code of 8888_test123.

    Component Example
    API URL http://statcgi.video.qcloud.com/common_access?
    cmd 1234
    interface Get_LivePlayStatHistory
    Param.n.start_time 1453279831
    Param.n.end_time 1453279835
    Param.s.stream_id 1234_xxx
    Param.s.domain www.123test.com
    t 1471850187
    sign b17971b51ba0fe5916ddcd96692e9fb3
    //When copying them, remove the invisible line breaks used for improving layout. Otherwise, URL construction errors may occur, such as "cmd is invalid".
    URL = http://statcgi.video.qcloud.com/common_access?
                cmd=1234&interface=Get_LivePlayStatHistory
                &Param.n.start_time =1453279831
                &Param.n.end_time =1453279835
                &Param.s.stream_id =1234_xxx
                            &Param.s.domain=www.123test.com
                &t=1471850187
          &sign=b17971b51ba0fe5916ddcd96692e9fb3
    

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help