该接口用于短剧时长事件上报。
请求结构 | 说明 |
---|---|
请求域名 | stream-api.feedcoopapi.com |
请求地址 | /user/action/log/skit/video_play/v1/ |
请求协议 | HTTP/HTTPS |
请求方式 | POST |
参数类型 | application/json |
url中传递通用参数,上报数据通过POST传递,格式为json数组,包含以下字段:
参数 | 描述 | 类型 | 是否必填 | 说明 |
---|---|---|---|---|
category | 频道名称 | String | 是 | 即从哪个页面进入短剧详情页的。 |
group_id | 内容id | Long | 是 | 即一个短剧视频的id |
req_id | 请求req_id | String | 是 | 即哪一次请求返回的这个短剧 |
chapter_id | 短剧id | Long | 是 | 即短剧集合的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。
|
参数 | 描述 | 类型 | 说明 |
---|---|---|---|
ret | 响应结果 | long | 参见“错误码”说明 |
msg | 本次请求是否成功 | String | success:成功 |
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 }