Sign in
播放历史

增加播放历史记录和评分

接口说明

此接口用于提交用户的播放历史数据，同时可以更新用户对某剧集的评分。

权限需求

此接口需要登录权限才可以调用。

参数限制说明

接口支持单个或批量增加历史数据。

提交的请求中，如果episodeIdList数组只包含一条数据，则addToFavorite参数（关注此作品）和rating参数（更新评分）可以生效。 如果episodeIdList数组包含不止一条数据，则会忽略addToFavorite和rating参数。

在批量添加历史记录时，episodeIdList数组最多只能包含100条数据，而且其中的episodeId必须全部属于同一部作品。

post/api/v2/playhistory

Request

  • Base URL: https://api.dandanplay.net
  • URL: https://api.dandanplay.net/api/v2/playhistory
  • Auth: one of:
    • API key in header X-AppId
    • API key in header X-AppSecret
    • HTTP bearer

Request body

episodeIdListinteger[] nullable

弹幕库编号列表（最多100项，必须都属于同一作品）

addToFavoriteboolean

关注此作品（弹幕库编号列表中必须只有一项）

ratinginteger

给此剧集打分（弹幕库编号列表中必须只有一项）。范围为1-10分，0代表不修改当前评分。

Response

返回播放历史添加结果

errorCodeinteger

错误代码，0表示没有发生错误，非0表示有错误，详细信息会包含在errorMessage属性中

successboolean

接口是否调用成功

errorMessagestring nullable

当发生错误时，说明错误具体原因

errorDetailstring nullable

当参数校验失败时，提供可供调用方定位问题字段的补充信息。

Changes

No recorded changes to this operation across all 1 revision of this API.