mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2024-12-27 13:00:29 +08:00
add APIdoc 【名词解释】
This commit is contained in:
社会易姐QwQ
parent
d1f6b217fc
commit
c1f007833c
@ -99,6 +99,7 @@ PS：所有http协议地址均可使用https，文档中为了统一写作`http`
|
||||
- 屏蔽管理
|
||||
- 智能防挡弹幕
|
||||
- [弹幕个人配置修改](danmaku/config.md)√
|
||||
- [名词解释](danmaku/buzzword.md)√
|
||||
- [视频笔记](note)√
|
||||
- [笔记列表](note/list.md)√
|
||||
- [笔记详细信息](note/info.md)√
|
||||
|
||||
513
danmaku/buzzword.md
Normal file
513
danmaku/buzzword.md
Normal file
@ -0,0 +1,513 @@
|
||||
# 名词解释
|
||||
|
||||
该功能用于解释和科普 B 站弹幕、评论等的专有名词及梗，展示其出处，并推荐相关站内内容
|
||||
|
||||
可使用页面 https://www.bilibili.com/blackboard/activity-joFQ0txEQd.html?type_id=4 查看名词列表
|
||||
|
||||
可使用页面 https://www.bilibili.com/blackboard/activity-WroMZNunfa.html?id=1 查看名词解释详情
|
||||
|
||||
- [拉取名词解释列表](#拉取名词解释列表)
|
||||
- [查询名词解释详情](#查询名词解释详情)
|
||||
|
||||
---
|
||||
|
||||
## 拉取名词解释列表
|
||||
|
||||
> http://api.bilibili.com/x/v2/dm/buzzword/list
|
||||
|
||||
*请求方式：GET*
|
||||
|
||||
**url参数：**
|
||||
|
||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||
| ------- | ---- | -------- | ------ | ---------------------------------------------- |
|
||||
| type_id | num | 名词类型 | 必要 | 如：4代表“哔哩哔哩热词图鉴”<br />5代表“语言类” |
|
||||
| pn | num | 页码 | 非必要 | 默认为1 |
|
||||
| ps | num | 每页项数 | 非必要 | 默认为20 |
|
||||
|
||||
**json回复：**
|
||||
|
||||
根对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ------- | ---- | -------- | --------------------------- |
|
||||
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
|
||||
| message | str | 错误信息 | 默认为0 |
|
||||
| ttl | num | 1 | |
|
||||
| data | obj | 数据本体 | |
|
||||
|
||||
`data`对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| --------- | ----- | -------- | ---- |
|
||||
| type | obj | 类型信息 | |
|
||||
| buzzwords | array | 词语列表 | |
|
||||
| page | obj | 页面信息 | |
|
||||
|
||||
`data`中的`type`对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ----------- | ---- | -------- | ------ |
|
||||
| id | num | 类型 id | |
|
||||
| name | str | 类型名称 | |
|
||||
| name_pinyin | obj | 拼音信息 | 见副表 |
|
||||
|
||||
`data`中的`buzzwords`数组：
|
||||
|
||||
| 项 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | --------------- | ---- |
|
||||
| 0 | obj | 名词条目 1 | |
|
||||
| n | obj | 名词条目（n+1） | |
|
||||
| …… | obj | …… | …… |
|
||||
|
||||
`buzzwords`数组中的对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ----------- | ---- | ------------ | ----------------------------------------- |
|
||||
| id | num | 名词 id | 用于[查询名词解释详情](#查询名词解释详情) |
|
||||
| name | str | 名词 | |
|
||||
| name_pinyin | obj | 拼音信息 | 见副表 |
|
||||
| picture | str | 名词图片 url | |
|
||||
|
||||
`data`中的`page`对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ----- | ---- | -------- | ---- |
|
||||
| num | num | 当前页码 | |
|
||||
| size | num | 每页项数 | |
|
||||
| total | num | 总计项数 | |
|
||||
| cnt | num | (?) | |
|
||||
|
||||
副表：拼音`name_pinyin`对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| -------------- | ---- | -------- | ---- |
|
||||
| 对应单个汉字 1 | str | 拼音字串 | |
|
||||
| 对应单个汉字 n | str | 拼音字串 | |
|
||||
| …… | str | …… | …… |
|
||||
|
||||
**示例：**
|
||||
|
||||
拉取对应`哔哩哔哩热词图鉴`的名词列表，以20项为一页拉取第1页
|
||||
|
||||
```bash
|
||||
curl -G 'http://api.bilibili.com/x/v2/dm/buzzword/list' \
|
||||
--data-urlencode 'type_id=4' \
|
||||
--data-urlencode 'ps=10' \
|
||||
--data-urlencode 'pn=1'
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary>查看响应示例：</summary>
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"message": "0",
|
||||
"ttl": 1,
|
||||
"data": {
|
||||
"type": {
|
||||
"id": 4,
|
||||
"name": "哔哩哔哩热词图鉴",
|
||||
"name_pinyin": {
|
||||
"哔": "bì",
|
||||
"哩": "lī",
|
||||
"图": "tú",
|
||||
"热": "rè",
|
||||
"词": "cí",
|
||||
"鉴": "jiàn"
|
||||
},
|
||||
"level": 0
|
||||
},
|
||||
"buzzwords": [
|
||||
{
|
||||
"id": 145,
|
||||
"name": "麦乐鸡侠",
|
||||
"name_pinyin": {
|
||||
"乐": "lè",
|
||||
"侠": "xiá",
|
||||
"鸡": "jī",
|
||||
"麦": "mài"
|
||||
},
|
||||
"picture": "https://i0.hdslb.com/bfs/archive/1cdec1ff86733a38c1a9ff824dde6d4121955aee.png"
|
||||
},
|
||||
{
|
||||
"id": 146,
|
||||
"name": "金钱豹",
|
||||
"name_pinyin": {
|
||||
"豹": "bào",
|
||||
"金": "jīn",
|
||||
"钱": "qián"
|
||||
},
|
||||
"picture": "https://i0.hdslb.com/bfs/archive/3d492f4c01da7d15073d3175871e14ed56f0f78a.png"
|
||||
},
|
||||
{
|
||||
"id": 11,
|
||||
"name": "通辽可汗",
|
||||
"name_pinyin": {
|
||||
"可": "kě",
|
||||
"汗": "hàn",
|
||||
"辽": "liáo",
|
||||
"通": "tōng"
|
||||
},
|
||||
"picture": "https://i0.hdslb.com/bfs/archive/ca332fb5f9da48497298cf26fe07b1f061e53a0b.jpg"
|
||||
},
|
||||
{
|
||||
"id": 123,
|
||||
"name": "资本马桶搋",
|
||||
"name_pinyin": {
|
||||
"搋": "chuāi",
|
||||
"本": "běn",
|
||||
"桶": "tǒng",
|
||||
"资": "zī",
|
||||
"马": "mǎ"
|
||||
},
|
||||
"picture": "https://i0.hdslb.com/bfs/archive/aaf33dced1941af0946f37c62f4b48fcaba9c9a2.jpg"
|
||||
},
|
||||
{
|
||||
"id": 133,
|
||||
"name": "马了顶大",
|
||||
"name_pinyin": {
|
||||
"了": "le",
|
||||
"大": "dà",
|
||||
"顶": "dǐng",
|
||||
"马": "mǎ"
|
||||
},
|
||||
"picture": "https://i0.hdslb.com/bfs/archive/9653bd7f8d2c804aceb8043ebd5c8360a93e26c0.png"
|
||||
},
|
||||
{
|
||||
"id": 9,
|
||||
"name": "退钱",
|
||||
"name_pinyin": {
|
||||
"退": "tuì",
|
||||
"钱": "qián"
|
||||
},
|
||||
"picture": "https://i0.hdslb.com/bfs/archive/2540db0bc94792b1f5be75e19aa05d33666e3036.jpg"
|
||||
},
|
||||
{
|
||||
"id": 141,
|
||||
"name": "森林冰火人",
|
||||
"name_pinyin": {
|
||||
"人": "rén",
|
||||
"冰": "bīng",
|
||||
"林": "lín",
|
||||
"森": "sēn",
|
||||
"火": "huǒ"
|
||||
},
|
||||
"picture": "https://i0.hdslb.com/bfs/archive/bc5ca101313d4db223c395d64779e76eb3482d60.jpg"
|
||||
},
|
||||
{
|
||||
"id": 22,
|
||||
"name": "学霸题",
|
||||
"name_pinyin": {
|
||||
"学": "xué",
|
||||
"霸": "bà",
|
||||
"题": "tí"
|
||||
},
|
||||
"picture": "https://i0.hdslb.com/bfs/archive/a67a0a57ec48beb8c8dcc9f26c7bb66cd0ed5da7.jpg"
|
||||
},
|
||||
{
|
||||
"id": 10,
|
||||
"name": "张三",
|
||||
"name_pinyin": {
|
||||
"三": "sān",
|
||||
"张": "zhāng"
|
||||
},
|
||||
"picture": "https://i0.hdslb.com/bfs/archive/f4dac6fdc5c58639b79ae87385e9b9f7eae3b263.png"
|
||||
},
|
||||
{
|
||||
"id": 5,
|
||||
"name": "饮茶先啦",
|
||||
"name_pinyin": {
|
||||
"先": "xiān",
|
||||
"啦": "la",
|
||||
"茶": "chá",
|
||||
"饮": "yǐn"
|
||||
},
|
||||
"picture": "https://i0.hdslb.com/bfs/archive/4c90ad207f0041e2dccd586827028aea50c2dc7d.jpg"
|
||||
}
|
||||
],
|
||||
"page": {
|
||||
"num": 1,
|
||||
"size": 10,
|
||||
"total": 143,
|
||||
"cnt": 0
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## 查询名词解释详情
|
||||
|
||||
> http://api.bilibili.com/x/v2/dm/buzzword/detail
|
||||
|
||||
*请求方式：GET*
|
||||
|
||||
**url参数：**
|
||||
|
||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||
| ------ | ---- | ------ | ------ | -------------------------------- |
|
||||
| id | num | 名词id | 必要 | 如：1代表“kksk”<br />2代表“打脸” |
|
||||
|
||||
**json回复：**
|
||||
|
||||
根对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ------- | --------------------------------- | -------- | --------------------------------------------------- |
|
||||
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：不存在该名词 |
|
||||
| message | str | 错误信息 | 默认为0 |
|
||||
| ttl | num | 1 | |
|
||||
| data | 有数据时：obj<br />无数据时：null | 数据本体 | |
|
||||
|
||||
`data`对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ----------------- | ------------------------------- | -------------------- | ----------------------------- |
|
||||
| id | num | 名词id | |
|
||||
| name | str | 名词 | |
|
||||
| description | str | 名词解释 | |
|
||||
| picture | str | 名词图片 url | |
|
||||
| types | array | 父分类列表 | 该名词可能隶属多个父分类 |
|
||||
| related_words | array | 近义词/相关词 | |
|
||||
| uppers | 有数据：array<br />无数据：null | 相关 UP 列表 | 该名词(梗)出处 |
|
||||
| related_ugc | 有数据：array<br />无数据：null | 相关 ucg 视频列表 | 该名词(梗)出处 |
|
||||
| related_ogv | 有数据：array<br />无数据：null | 相关 pgc 视频列表 | 该名词(梗)出处 |
|
||||
| guides | obj | 推荐创作信息 | |
|
||||
| related_buzzwords | array | 推荐名词列表 | |
|
||||
| topic | obj | 关联话题信息 | |
|
||||
| show_dynamic | bool | 是否展示话题动态聚合 | `true`展示<br />`false`不展示 |
|
||||
|
||||
`data`中的`types`数组：
|
||||
|
||||
| 项 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | ------------- | ---- |
|
||||
| 0 | obj | 父分类 1 | |
|
||||
| n | obj | 父分类（n+1） | |
|
||||
| …… | obj | …… | …… |
|
||||
|
||||
`types`数组中的对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ----------- | ---- | -------- | ---- |
|
||||
| id | num | 类型 id | |
|
||||
| name | str | 类型名称 | |
|
||||
| name_pinyin | null | | |
|
||||
| level | num | 权重？ | |
|
||||
|
||||
`data`中的`related_words`数组：
|
||||
|
||||
| 项 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | -------------------- | ---- |
|
||||
| 0 | str | 近义词/相关词1 | |
|
||||
| n | str | 近义词/相关词（n+1） | |
|
||||
| …… | str | …… | …… |
|
||||
|
||||
`data`中的`uppers`数组：
|
||||
|
||||
| 项 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | -------------- | ---- |
|
||||
| 0 | obj | 相关 UP 1 | |
|
||||
| n | obj | 相关 UP（n+1） | |
|
||||
| …… | obj | …… | …… |
|
||||
|
||||
`uppers`数组中的对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ---------- | ---- | ------------- | ------------------------------------------------------------ |
|
||||
| id | num | UP 主 mid | |
|
||||
| recommend | str | | |
|
||||
| name | str | UP 主昵称 | |
|
||||
| face | str | UP 主头像 url | |
|
||||
| official | obj | UP 主认证信息 | |
|
||||
| followed | bool | 是否关注 | 需要登录(Cookie 或 APP)<br />`true`已关注<br />`false`未关注 |
|
||||
| fans_count | num | 粉丝数 | |
|
||||
|
||||
`data`中的`related_ugc`数组：
|
||||
|
||||
| 项 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | -------------------- | ---- |
|
||||
| 0 | obj | 相关 ucg 视频 1 | |
|
||||
| n | obj | 相关 ucg 视频（n+1） | |
|
||||
| …… | obj | …… | …… |
|
||||
|
||||
`related_ugc`数组中的对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| -------- | ---- | ------------ | -------- |
|
||||
| aid | num | 视频 avid | |
|
||||
| cid | num | 视频 1P cid | |
|
||||
| name | str | 视频标题 | |
|
||||
| link | str | 空 | |
|
||||
| play | num | 播放数 | |
|
||||
| danmaku | num | 弹幕数 | |
|
||||
| duration | num | 视频时长 | 单位为秒 |
|
||||
| cover | str | 视频封面 url | |
|
||||
|
||||
`data`中的`related_ogv`数组：
|
||||
|
||||
| 项 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | -------------------- | ---- |
|
||||
| 0 | obj | 相关 pgc 视频 1 | |
|
||||
| n | obj | 相关 pgc 视频（n+1） | |
|
||||
| …… | obj | …… | …… |
|
||||
|
||||
`related_ogv`数组中的对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ----------- | ---- | ------------ | ------------------------------------- |
|
||||
| season_id | num | 剧集 ssid | |
|
||||
| name | str | 剧集标题 | |
|
||||
| play | num | 播放数 | |
|
||||
| followed | num | 追剧/番数 | |
|
||||
| is_followed | bool | 是否追剧/番 | `true`已追剧/番<br />`false`未追剧/番 |
|
||||
| new_ep | str | 最新一集信息 | |
|
||||
| cover | str | 剧集封面 url | |
|
||||
| episodes | null | | |
|
||||
| follow_info | obj | | |
|
||||
|
||||
`data`中的`guides`对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| --------------- | ----- | ---------------- | ---- |
|
||||
| description | str | 创作推介文案 | |
|
||||
| contribute_tags | array | 创作跳转按钮信息 | |
|
||||
|
||||
`guides`中的`contribute_tags`数组：
|
||||
|
||||
| 项 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | ------------------- | ---- |
|
||||
| 0 | obj | 创作跳转按钮 1 | |
|
||||
| n | obj | 创作跳转按钮（n+1） | |
|
||||
| …… | obj | …… | …… |
|
||||
|
||||
`contribute_tags`数组中的对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ----- | ---- | -------- | -------------------------- |
|
||||
| title | str | 按钮文案 | |
|
||||
| link | str | 跳转 uri | 跳转至必剪或客户端创作入口 |
|
||||
|
||||
`data`中的`related_buzzwords`数组：
|
||||
|
||||
| 项 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | --------------- | ---- |
|
||||
| 0 | obj | 推荐名词 1 | |
|
||||
| n | obj | 推荐名词（n+1） | |
|
||||
| …… | obj | …… | …… |
|
||||
|
||||
`related_buzzwords`数组中的对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ----------- | ---- | ------- | ----------------------------------------- |
|
||||
| id | num | 名词 id | 用于[查询名词解释详情](#查询名词解释详情) |
|
||||
| name | str | 名词 | |
|
||||
| name_pinyin | null | | |
|
||||
| picture | str | 空 | |
|
||||
|
||||
`data`中的`topic`对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ---------- | ---- | ------------ | ---- |
|
||||
| topic_id | num | 关联话题id | |
|
||||
| topic_name | str | 关联话题名称 | |
|
||||
|
||||
**示例：**
|
||||
|
||||
查询名词`kksk`的详情
|
||||
|
||||
```bash
|
||||
curl -G 'http://api.bilibili.com/x/v2/dm/buzzword/detail' \
|
||||
--data-urlencode 'id=1'
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary>查看响应示例：</summary>
|
||||
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"message": "0",
|
||||
"ttl": 1,
|
||||
"data": {
|
||||
"id": 1,
|
||||
"name": "kksk",
|
||||
"description": "该梗是日语“ここすき”罗马音的字母缩写，翻译为喜欢这里。一般作为赞扬认可的弹幕出现在视频画面中。由于在2017年随着以《恶魔人》为BGM和语音剪辑素材的《美洲豹人》系列作品的传播，让这个梗快速的通过弹幕流行开，并频繁出现在各类稿件经典画面中。",
|
||||
"picture": "https://i0.hdslb.com/bfs/archive/c269c9ca1b5eb730ee1d77aadd28e3165eaa4d6d.png",
|
||||
"types": [
|
||||
{
|
||||
"id": 4,
|
||||
"name": "哔哩哔哩热词图鉴",
|
||||
"name_pinyin": null,
|
||||
"level": 0
|
||||
},
|
||||
{
|
||||
"id": 5,
|
||||
"name": "语言类",
|
||||
"name_pinyin": null,
|
||||
"level": 0
|
||||
},
|
||||
{
|
||||
"id": 9,
|
||||
"name": "空耳",
|
||||
"name_pinyin": null,
|
||||
"level": 0
|
||||
}
|
||||
],
|
||||
"related_words": [
|
||||
"恶魔人",
|
||||
"美洲豹人",
|
||||
"喜欢这里"
|
||||
],
|
||||
"uppers": [
|
||||
{
|
||||
"id": 488450,
|
||||
"recommend": "",
|
||||
"name": "PXN1",
|
||||
"face": "http://i2.hdslb.com/bfs/face/96dd8cc4f2922bd81e5a938f6ad02b3e3041debe.jpg",
|
||||
"official": {
|
||||
"role": 0,
|
||||
"title": "",
|
||||
"desc": "",
|
||||
"type": -1
|
||||
},
|
||||
"followed": false,
|
||||
"fans_count": 1416
|
||||
}
|
||||
],
|
||||
"related_ugc": [
|
||||
{
|
||||
"aid": 30056798,
|
||||
"cid": 52388183,
|
||||
"name": "恶 魔 人",
|
||||
"link": "",
|
||||
"play": 3434500,
|
||||
"danmaku": 8292,
|
||||
"duration": 188,
|
||||
"cover": "http://i0.hdslb.com/bfs/archive/f0433d2dacf4b3397a9390ab982cefd138dbf8c8.jpg"
|
||||
}
|
||||
],
|
||||
"related_ogv": null,
|
||||
"guides": {
|
||||
"description": "使用同款热梗素材创作你的专属作品吧！添加热梗主题#kksk是什么梗#参与投稿，优质稿件会优先展示在哔哩哔哩热词图鉴相关推荐中哦！",
|
||||
"contribute_tags": [
|
||||
{
|
||||
"title": "拍同款",
|
||||
"link": "bilibili://uper/appTraffic?appScheme=bcut%3A%2F%2Fstudio%2Fmaterial_editor%2F%3Ftab_id%3D1%26sub_id%3D90160%26third_id%3D150281&appName=com.bilibili.studio&appID=1299589486"
|
||||
}
|
||||
]
|
||||
},
|
||||
"related_buzzwords": null,
|
||||
"topic": {
|
||||
"topic_id": 7642,
|
||||
"topic_name": "kksk是什么梗"
|
||||
},
|
||||
"show_dynamic": false
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
</details>
|
||||
Loading…
Reference in New Issue
Block a user