You need to enable JavaScript to run this app.
导航
短剧时长
最近更新时间:2024.06.05 18:55:22首次发布时间:2024.02.02 14:03:28

该接口用于短剧时长事件上报。

请求结构说明
请求域名stream-api.feedcoopapi.com
请求地址/user/action/log/skit/video_play/v1/
请求协议HTTP/HTTPS
请求方式POST
参数类型application/json

请求参数

url中传递通用参数,上报数据通过POST传递,格式为json数组,包含以下字段:

参数描述类型是否必填说明
category频道名称String即从哪个页面进入短剧详情页的。
group_id内容idLong即一个短剧视频的id
req_id请求req_idString即哪一次请求返回的这个短剧
chapter_id短剧idLong即短剧集合的id,不同集数共同的id。
order短剧集数Int短剧集数(第一集就是1)
is_paid是否解锁Int通过看广告或者支付钻石进行解锁,1表示解锁,0表示否。
例如某剧集的前3集免费,第四集需要付费解锁,那前三集的这个字段都是0,用户付费后播放第四集,就报1。
duration实际播放时长Long单位ms。 当次播放的实际时长,排除拖动进度条的时长。
例如播放了3s,又拖动了2s,又播放1s,报4000。
progress_duration剧情时长Long当次播放剧情时长,排除拖动进度条的时长,还原倍速播放,取实际播放视频的时长,单位ms。
例如2倍速播放了3秒,那就报6000,又拖动了2s,仍报6000,而不是8000。
percent播放进度Int当前视频最大播放进度,拖动进度条也算,上限100。
  • case1:当前视频10s,进度条拖动到9s,percent=90;
  • case2:当前视频10s,拖动进度条到9s,又拖动回2s,percent=90,而不是20;
  • case3:视频播放完一遍,自动重新播放,percent=100;

响应参数

参数描述类型说明
ret响应结果long

参见“错误码”说明

msg本次请求是否成功Stringsuccess:成功
req_id本次请求标识String惟一标识本次请求,火山引擎侧使用该字段进行具体问题追踪和排查

请求示例

POST /user/action/log/skit/video_over/v1/?timestamp=1706687279&signature=***&nonce=123&partner=***_default_content&access_token=*** HTTP/1.1
Host: stream-api.feedcoopapi.com
Content-Type: application/json
[ 
 {
    "category":"list_category",
    "group_id":123,
    "req_id":"20240131165550484C5C77C96EE61D3***",
    "chapter_id":123,
    "order":1,
    "is_paid":1,
    "duration":10000,
    "progress_duration":20000,
    "percent":10
 }
]

响应示例

{
    "data": [],
    "msg": "success",
    "req_id": "20240131170715F23196A8AFEC64E58***",
    "ret": 0
}