弹幕

向指定弹幕库发送弹幕(开放弹幕网络)

接口说明

此接口用于开放弹幕网络第三方应用开发者向指定弹幕库发送弹幕。

调用方通过 AppId/AppSecret 鉴权,可自行设置用户名,弹幕将与官方弹幕分开存储。

应用使用此接口发送弹幕后,使用 GET /comment/{episodeId} 接口获取弹幕时,返回的弹幕中将包含本应用发送的弹幕。

不同应用发送的弹幕将分别存储在不同的私有弹幕库中,互不干扰。

权限说明

当前只有社区合作和商业授权层级的应用有此接口完整额度。其他层级的应用也可以调用此接口,但额度仅限于测试使用。

post/api/v2/comment/{episodeId}/app

Request

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

Path parameters

episodeIdinteger required

弹幕库ID

Request body

timenumber double

弹幕出现时间,单位为秒

modeinteger

弹幕模式:1-普通弹幕,4-顶部弹幕,5-底部弹幕

colorinteger

弹幕颜色,计算方式为 Rx255x255+Gx255+B

commentstring nullable

弹幕内容,不能长于100个字符

userNamestring nullable

弹幕发送者昵称,由调用方应用自行指定。

Response

errorCodeinteger

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

successboolean

接口是否调用成功

errorMessagestring nullable

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

errorDetailstring nullable

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

cidinteger

此弹幕库中的弹幕ID

Changes

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