Skip to content

Commit

Permalink
统一“id”为小写,并将“UID”改为“mid”,调整【视频属性数据】文档
Browse files Browse the repository at this point in the history
  • Loading branch information
SocialSisterYi committed Jul 12, 2021
1 parent 3512adf commit a7a743d
Show file tree
Hide file tree
Showing 87 changed files with 1,031 additions and 982 deletions.
6 changes: 3 additions & 3 deletions APP_widget/splash.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@

| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | --------------------- | ---- |
| id | num | 开屏图片ID | |
| id | num | 开屏图片id | |
| thumb | str | 开屏图片url | |
| logo_url | str | “bilibili”logo图片url | |

Expand All @@ -67,7 +67,7 @@

| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------- | ------------ |
| id | num | 开屏图片ID | |
| id | num | 开屏图片id | |
| begin_time | num | 起始时间? | 时间戳 |
| end_time | num | 结束时间? | 时间戳 |
| probability | num | 0 | 作用尚不明确 |
Expand Down Expand Up @@ -136,7 +136,7 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \

</details>

如ID=11的图片为:
如id=11的图片为:

![]( http://i0.hdslb.com/bfs/archive/fe737da5cdedf9dad038e5fd30e957be8a063bc2.png )

3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ PS:所有http协议地址均可使用https,文档中为了统一写作`http`
- [API认证与鉴权(APP与Cookie方式)](other/API_auth.md)×
- [公共错误码](other/errcode.md)
- [图片格式化](other/picture.md)
- [bvID说明](other/bvID.md)
- [bvid说明](other/bvid_desc.md)
- [grpc接口](grpc_api)×
- [登录](login)
- [登录操作(人机认证)](login/login_action)
Expand Down Expand Up @@ -79,6 +79,7 @@ PS:所有http协议地址均可使用https,文档中为了统一写作`http`
- [互动视频](video/interact_video.md)×
- [高能进度条](video/pbp.md)
- [信息上报(心跳及记录历史)](video/report.md)×
- [视频属性数据](video/attribute_data.md)
- [剧集(番剧、影视)](bangumi)
- [基本信息](bangumi/info.md)×
- 状态数
Expand Down
12 changes: 6 additions & 6 deletions album/action.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | ---------------------- |
| doc_id | num | 相簿ID | 必要 | |
| doc_id | num | 相簿id | 必要 | |
| type | num | 操作方式 | 必要 | 1:点赞<br />2:取消赞 |
| csrf_token | str | CSRF Token(位于cookie) | 非必要 | |

Expand All @@ -41,7 +41,7 @@

**示例:**

点赞相簿`ID=99184721`
点赞相簿`id=99184721`

```shell
curl 'http://api.vc.bilibili.com/link_draw/v2/Vote/operate' \
Expand Down Expand Up @@ -79,7 +79,7 @@ curl 'http://api.vc.bilibili.com/link_draw/v2/Vote/operate' \

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | ------------ |
| fav_id | num | 相簿ID | 必要 | |
| fav_id | num | 相簿id | 必要 | |
| biz_type | num | 2 | 必要 | 作用尚不明确 |
| csrf_token | str | CSRF Token(位于cookie) | 非必要 | |

Expand All @@ -96,7 +96,7 @@ curl 'http://api.vc.bilibili.com/link_draw/v2/Vote/operate' \

**示例:**

收藏相簿`ID=99184721`
收藏相簿`id=99184721`

```shell
curl 'http:///api.vc.bilibili.com/user_plus/v1/Fav/add' \
Expand Down Expand Up @@ -133,7 +133,7 @@ curl 'http:///api.vc.bilibili.com/user_plus/v1/Fav/add' \

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | ------------ |
| fav_id | num | 相簿ID | 必要 | |
| fav_id | num | 相簿id | 必要 | |
| biz_type | num | 2 | 必要 | 作用尚不明确 |
| csrf_token | str | CSRF Token(位于cookie) | 非必要 | |

Expand All @@ -150,7 +150,7 @@ curl 'http:///api.vc.bilibili.com/user_plus/v1/Fav/add' \

**示例:**

取消收藏相簿`ID=99184721`
取消收藏相簿`id=99184721`

```shell
curl 'http://api.vc.bilibili.com/user_plus/v1/Fav/delete' \
Expand Down
10 changes: 5 additions & 5 deletions album/info.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ---- |
| doc_id | num | 目标相簿ID | 必要 | |
| doc_id | num | 目标相簿id | 必要 | |

**json回复:**

Expand All @@ -40,7 +40,7 @@

| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ---------- | ---- |
| uid | num | 作者UID | |
| uid | num | 作者mid | |
| head_url | str | 头像url | |
| name | str | 昵称 | |
| vip | obj | 会员信息 | |
Expand Down Expand Up @@ -70,8 +70,8 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ----- | ------------------ | ------------------------------------------------------------ |
| biz | num | 相簿分区 | 1:画友<br />2:摄影<br />3:日常 |
| doc_id | num | 相簿ID | |
| poster_uid | num | 作者UID | |
| doc_id | num | 相簿id | |
| poster_uid | num | 作者mid | |
| category | str | 子分区标识 | cos:cosplay<br />daily:日常<br />illustration:插画<br />comic:漫画<br />draw:其他<br />sifu:私服 |
| type | num | 相簿类型 | 0:原创<br />1:同人 |
| title | str | 标题 | |
Expand Down Expand Up @@ -140,7 +140,7 @@

**示例:**

查询相簿`ID=99184721`的详细信息
查询相簿`id=99184721`的详细信息

```shell
curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/detail' \
Expand Down
10 changes: 5 additions & 5 deletions album/list.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,16 +61,16 @@

| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------- | ---- |
| uid | num | 作者UID | |
| uid | num | 作者mid | |
| head_url | str | 头像url | |
| name | str | 昵称 | |

`data`中的`items`数组中的对象中的`item`对象:

| 字段 | 类型 | 内容 | 备注 |
| ------------- | ----- | ---------- | --------------------------------- |
| doc_id | num | 相簿ID | |
| poster_uid | num | 作者UID | |
| doc_id | num | 相簿id | |
| poster_uid | num | 作者mid | |
| pictures | array | 相簿图片 | |
| title | str | 标题 | |
| category | str | 子分区名 | |
Expand Down Expand Up @@ -1340,7 +1340,7 @@ curl -G 'http://api.vc.bilibili.com/link_draw/v2/Photo/list' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------- | ------ | --------------------------------------------- |
| biz | num | 分区 | 非必要 | 0:全部<br />1:画友<br/>2:摄影<br />默认为0 |
| poster_uid | num | 作者UID | 必要 | 默认为20 |
| poster_uid | num | 作者mid | 必要 | 默认为20 |
| page_num | num | 页码 | 非必要 | 默认为1 |
| page_size | num | 每页项数 | 非必要 | 默认为45 |

Expand All @@ -1367,7 +1367,7 @@ curl -G 'http://api.vc.bilibili.com/link_draw/v2/Photo/list' \

| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------- | ---- |
| uid | str | 作者UID | |
| uid | str | 作者mid | |
| head_url | str | 头像url | |
| name | str | 昵称 | |

Expand Down
2 changes: 1 addition & 1 deletion album/recommend_author.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@

| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------- | ------------ |
| uid | num | 作者UID | |
| uid | num | 作者mid | |
| head_url | str | 头像url | |
| name | str | 昵称 | |
| is_followed | num | 0 | 作用尚不明确 |
Expand Down
10 changes: 5 additions & 5 deletions article/articles.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| id | num | 文集rlID | 必要 | |
| id | num | 文集rlid | 必要 | |

**json回复:**

Expand All @@ -43,8 +43,8 @@

| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | --------------- | ------------ |
| id | num | 文集rlID | |
| mid | num | 文集作者UID | |
| id | num | 文集rlid | |
| mid | num | 文集作者mid | |
| name | str | 文集名称 | |
| image_url | str | 文集封面图片url | |
| update_time | num | 文集更新时间 | 时间戳 |
Expand All @@ -70,7 +70,7 @@

| 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | -------------- | ------------------------------------------------------------ |
| id | num | 专栏cvID | |
| id | num | 专栏cvid | |
| title | str | 文章标题 | |
| state | num | 0 | 作用尚不明确 |
| publish_time | num | 发布时间 | 秒时间戳 |
Expand Down Expand Up @@ -99,7 +99,7 @@

| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | -------------- | ---- |
| mid | num | 作者UID | |
| mid | num | 作者mid | |
| name | str | 作者昵称 | |
| face | str | 作者头像url | |
| official_verify | obj | 作者认证信息 | |
Expand Down
8 changes: 4 additions & 4 deletions article/info.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| id | num | 专栏cvID | 必要 | |
| id | num | 专栏cvid | 必要 | |

**json回复:**

Expand All @@ -40,7 +40,7 @@
| stats | obj | 状态数信息 | |
| title | str | 文章标题 | |
| banner_url | str | 文章头图url | |
| mid | num | 文章作者UID | |
| mid | num | 文章作者mid | |
| author_name | str | 文章作者昵称 | |
| is_author | bool | true | 作用尚不明确 |
| image_urls | array | 动态封面 | |
Expand All @@ -49,8 +49,8 @@
| show_later_watch | bool | true | 作用尚不明确 |
| show_small_window | bool | true | 作用尚不明确 |
| in_list | bool | 是否收于文集 | false:否<br />true:是 |
| pre | num | 上一篇文章cvID | 无为0 |
| next | num | 下一篇文章cvID | 无为0 |
| pre | num | 上一篇文章cvid | 无为0 |
| next | num | 下一篇文章cvid | 无为0 |
| share_channels | array | 分享方式列表 | |

`stats`对象:
Expand Down
6 changes: 3 additions & 3 deletions article/like_coin_fav.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---------------------- |
| id | num | 文章cvID | 必要 | |
| id | num | 文章cvid | 必要 | |
| type | num | 操作方式 | 必要 | 1:点赞<br />2:取消赞 |
| csrf | str | CSRF Token(位于cookie) | 必要 | |

Expand Down Expand Up @@ -73,7 +73,7 @@ curl 'http://api.bilibili.com/x/article/like' \

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------- | ------ | ------- |
| aid | num | 文章cvID | 必要 | |
| aid | num | 文章cvid | 必要 | |
| multiply | num | 投币数量 | 必要 | 上限为2 |
| avtype | num | 2 | 必要 | 必须为2 |
| csrf | str | CSRF Token(位于cookie) | 必要 | |
Expand Down Expand Up @@ -138,7 +138,7 @@ curl 'http://api.bilibili.com/x/web-interface/coin/add' \

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---- |
| id | num | 文章cvID | 必要 | |
| id | num | 文章cvid | 必要 | |
| csrf | str | CSRF Token(位于cookie) | 必要 | |

**json回复:**
Expand Down
4 changes: 2 additions & 2 deletions audio/coin&fav.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | |
| sid | num | 音频auid | 必要 | |

**json回复:**

Expand Down Expand Up @@ -68,7 +68,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/songs-col

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | |
| sid | num | 音频auid | 必要 | |

**json回复:**

Expand Down
Loading

0 comments on commit a7a743d

Please sign in to comment.