article
-- import "."
Usage
type BiliBiliArticleClient
go
type BiliBiliArticleClient struct {
*kernel.BaseClient
}
BiliBiliArticleClient 表示 B 站文章相关的客户端
func NewClient
go
func NewClient(c *kernel.BaseClient) *BiliBiliArticleClient
NewClient 创建 B 站文章相关的客户端
func (*BiliBiliArticleClient) Add
go
func (c *BiliBiliArticleClient) Add(ctx context.Context, data *schema.BiliBiliArticleAddReq) (*schema.BiliBiliArticleAddRes, error)
Add 提交文章
接口文档参考: https://open.bilibili.com/doc/4/b14b77b6-8889-8c8b-2e83-17c5a4c550fb#h1-u6587u7AE0u63D0u4EA4
参数:
ctx - 请求上下文
data - 请求参数,包含以下字段:
• title: 文章标题,建议30字以内,最多不超过40字
• category: 文章分类,通过categories接口获取,填写子分类id
• template_id: 选择稿件模板
• summary: 文章简介,字数不少于200字
• content: 正文内容,字数200-40000,或者至少添加三张图片
• banner_url: 头图url,与top_video_bvid可都不填写,或者只能二选一
• original: 是否原创:0-非原创 1-原创 默认0
• image_urls: 封面默认使用正文文字图片,多个图片用英文逗号分割
• tags: 用户自定义标签,多标签情况下用英文逗号分割
• list_id: 文集id
• up_closed_reply: 是否up主关闭评论区:0-否 1-是 默认0
• top_video_bvid: 头部视频bvid,与banner_url可都不填写,或者只能二选一
返回值:
*schema.BiliBiliArticleAddRes 包含以下字段:
• code: 响应码
• message: 响应消息
• request_id: 请求ID
• ttl: TTL
• data: 响应数据,包含新建的文章id
error 调用过程中遇到的错误(如有)
func (*BiliBiliArticleClient) Card
go
func (c *BiliBiliArticleClient) Card(ctx context.Context, data *schema.BiliBiliArticleCardReq) (*schema.BiliBiliArticleCardRes, error)
Card 获取视频、文章卡片信息 接口文档参考:
https://open.bilibili.com/doc/4/120b97a6-24a1-4e9f-47b7-9a201196e5d3#h1-- 参数:
ctx - 请求上下文
data - 请求参数,包含以下字段:
• ResourceID: 资源id(视频BV号/文章cv号):BV开头为视频,cv开头为文章
返回值:
*schema.BiliBiliArticleCardRes 包含以下字段:
• Code: 状态码
• Message: 返回消息
• RequestID: 请求ID
• TTL: 生存时间
• Data: 卡片片段
error 调用过程中遇到的错误(如有)
func (*BiliBiliArticleClient) Categories
go
func (c *BiliBiliArticleClient) Categories(ctx context.Context, data *schema.BiliBiliArticleCategoriesReq) (*schema.BiliBiliArticleCategoriesRes, error)
Categories 获取文章的分类列表 接口文档参考:
ctx - 请求上下文
data - 请求参数,包含以下字段:
返回值:
*schema.BiliBiliArticleCategoriesRes 包含以下字段:
• Code: 状态码
• Message: 返回消息
• RequestID: 请求ID
• TTL: 生存时间
• Data: 分类列表数据
error 调用过程中遇到的错误(如有)
func (*BiliBiliArticleClient) Delete
go
func (c *BiliBiliArticleClient) Delete(ctx context.Context, data *schema.BiliBiliArticleDeleteReq) (*schema.BiliBiliArticleDeleteRes, error)
Delete 删除文章
接口文档参考: https://open.bilibili.com/doc/4/b63f8918-2add-0fbb-0718-d0537329ed1c#h1-u6587u7AE0u5220u9664
参数:
ctx - 请求上下文
data - 请求参数,包含以下字段:
• ID: 文章ID(必填,支持多个ID,用英文逗号分隔)
返回值:
*schema.BiliBiliArticleDeleteRes 包含以下字段:
• Code: 返回码
• Message: 返回信息
• RequestID: 请求ID
• TTL: 请求有效期
error 调用过程中遇到的错误(如有)
func (*BiliBiliArticleClient) Detail
go
func (c *BiliBiliArticleClient) Detail(ctx context.Context, data *schema.BiliBiliArticleDetailReq) (*schema.BiliBiliArticleDetailRes, error)
Detail 查询文章详情
参数:
ctx - 请求上下文
data - 请求参数,包含以下字段:
• ID: 文章ID(必填)
返回值:
*schema.BiliBiliArticleDetailRes 包含以下字段:
• Code: 返回码
• Message: 返回信息
• TTL: 请求有效期
• Data: 文章详情数据
error 调用过程中遇到的错误(如有)
func (*BiliBiliArticleClient) Edit
go
func (c *BiliBiliArticleClient) Edit(ctx context.Context, data *schema.BiliBiliArticleEditReq) (*schema.BiliBiliArticleEditRes, error)
Edit 编辑文章
接口文档参考: https://open.bilibili.com/doc/4/2b5284bd-9a40-247b-8da6-0ef7cd00afd3#h1-u6587u7AE0u7F16u8F91
参数:
ctx - 请求上下文
data - 请求参数,包含以下字段:
• id: 文章ID
• title: 文章标题,建议30字以内,最多不超过40字
• category: 文章分类,通过categories接口获取,填写子分类id
• template_id: 选择稿件模板
• summary: 文章简介,字数不少于200字
• content: 正文内容,字数200-40000,或者至少添加三张图片
• banner_url: 头图url,与top_video_bvid可都不填写,或者只能二选一
• original: 是否原创:0-非原创 1-原创 默认0
• image_urls: 封面默认使用正文文字图片,多个图片用英文逗号分割
• tags: 用户自定义标签,多标签情况下用英文逗号分割
• list_id: 文集id
• up_closed_reply: 是否up主关闭评论区:0-否 1-是 默认0
• top_video_bvid: 头部视频bvid,与banner_url可都不填写,或者只能二选一
返回值:
*schema.BiliBiliArticleEditRes 包含以下字段:
• code: 响应码
• message: 响应消息
• request_id: 请求ID
• ttl: TTL
• data: 响应数据,包含编辑后的文章id
error 调用过程中遇到的错误(如有)
func (*BiliBiliArticleClient) List
go
func (c *BiliBiliArticleClient) List(ctx context.Context, data *schema.BiliBiliArticleListReq) (*schema.BiliBiliArticleListRes, error)
List 查询文章列表 接口文档参考:
ctx - 请求上下文
data - 请求参数,包含以下字段:
• PN: 页码(可选,默认1)
• PS: 每页大小(可选,默认10)
• Sort: 排序类型(可选,默认1)
• Group: 文章状态分组(可选,默认0)
• Category: 分类ID(可选)
返回值:
*schema.BiliBiliArticleListRes 包含以下字段:
• Code: 状态码
• Message: 返回消息
• TTL: 生存时间
• Data: 文章列表数据
error 调用过程中遇到的错误(如有)
func (*BiliBiliArticleClient) UploadImage
go
func (c *BiliBiliArticleClient) UploadImage(ctx context.Context, data *schema.BiliBiliArticleUploadImageReq) (*schema.BiliBiliArticleUploadImageRes, error)
UploadImage 专栏稿件图片上传
参数:
ctx - 请求上下文
data - 请求参数,包含以下字段:
• Files: 图片文件
• Form: 表单数据
• Watermark: 是否带水印
返回值:
*schema.BiliBiliArticleUploadImageRes 包含以下字段:
• Code: 响应状态码
• Message: 响应消息
• Data: 图片上传结果数据
error 调用过程中遇到的错误(如有)