返回提交历史
Modified
user/space.md
+168
-2
XFEstudio/bilibili-API-collect
添加设置和取消置顶视频以及代表作视频的4个api
8812c09
代码差异
1 个文件
+168
-2
@@ -1630,7 +1630,7 @@ curl -b "SESSDATA=xxx" -d "user_sign=%E9%AB%98%E4%B8%AD%E6%8A%80%E6%9C%AF%E5%AE%
1630
1630
1631
1631
| 字段 | 类型 | 内容 | 备注 |
1632
1632
| ------- | ---- | -------- | ------------------------------------------------------------ |
1633
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-304：未修改<br />-400：请求错误 |
1633
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-304：未修改<br />-400：请求错误（超出长度限制） |
1634
1634
| message | str | 错误信息 | 默认为0 |
1635
1635
| ttl | num | 1 | 作用尚不明确 |
1636
1636
@@ -1673,7 +1673,7 @@ curl -b "sessdata=xxx" -d "csrf=xxx¬ice=%E9%B8%BD%E5%AD%90" "http://api.bilib
1673
1673
1674
1674
| 字段 | 类型 | 内容 | 备注 |
1675
1675
| ------- | ---- | -------- | ------------------------------------------------------------ |
1676
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误 |
1676
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误（超出长度限制） |
1677
1677
| message | str | 错误信息 | 默认为0 |
1678
1678
| ttl | num | 1 | 作用尚不明确 |
1679
1679
@@ -1691,3 +1691,169 @@ curl -b "SESSDATA=xxx;DedeUserID=1" -d "csrf=xxx&tags=minecraft%2C%E6%8A%80%E6%9
1691
1691
}
1692
1692
```
1693
1693
1694
1695
1696
### 修改（添加）置顶视频
1697
1698
> http://api.bilibili.com/x/space/top/arc/set
1699
1700
*方式：POST*
1701
1702
需要登录(SESSDATA)
1703
1704
**参数（ application/x-www-form-urlencoded ）：**
1705
1706
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
1707
| ------ | ---- | ------------------- | ------ | ------------------ |
1708
| aid | data | 置顶目标视频avID | 非必要 | avID与bvID任选一个 |
1709
| bvid | data | 置顶目标视频bvID | 非必要 | avID与bvID任选一个 |
1710
| reason | data | 置顶视频备注 | 非必要 | 置顶备注最大40字符 |
1711
| csrf | data | cookies中的bili_jct | 必要 | |
1712
1713
**json回复：**
1714
1715
根对象：
1716
1717
| 字段 | 类型 | 内容 | 备注 |
1718
| ------- | ---- | -------- | ------------------------------------------------------------ |
1719
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-304：未修改<br />-400：请求错误<br />53014：稿件已失效<br />53015：备注过长<br />53017：置顶非自己的稿件 |
1720
| message | str | 错误信息 | 默认为0 |
1721
| ttl | num | 1 | 作用尚不明确 |
1722
1723
**示例：**
1724
1725
置顶视频`av98948772`/`BV1n741127LD`
1726
1727
curl -b "SESSDATA=xxx" -b "aid=98948772&csrf=xxx" "http://api.bilibili.com/x/space/top/arc/set"
1728
1729
同curl -b "SESSDATA=xxx" -b "bvid=BV1n741127LD&csrf=xxx" "http://api.bilibili.com/x/space/top/arc/set"
1730
1731
```json
1732
{
1733
"code": 0,
1734
"message": "0",
1735
"ttl": 1
1736
}
1737
```
1738
1739
1740
1741
### 取消置顶视频
1742
1743
> http://api.bilibili.com/x/space/top/arc/cancel
1744
1745
*方式：POST*
1746
1747
需要登录(SESSDATA)
1748
1749
**参数（ application/x-www-form-urlencoded ）：**
1750
1751
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
1752
| ------ | ---- | ------------------- | ------ | ---- |
1753
| csrf | data | cookies中的bili_jct | 必要 | |
1754
1755
**json回复：**
1756
1757
根对象：
1758
1759
| 字段 | 类型 | 内容 | 备注 |
1760
| ------- | ---- | -------- | ------------------------------------------------------------ |
1761
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误（重复取消） |
1762
| message | str | 错误信息 | 默认为0 |
1763
| ttl | num | 1 | 作用尚不明确 |
1764
1765
**示例：**
1766
1767
curl -b "SESSDATA=xxx" -d "csrf=xxx" "http://api.bilibili.com/x/space/top/arc/cancel"
1768
1769
```json
1770
{
1771
"code": 0,
1772
"message": "0",
1773
"ttl": 1
1774
}
1775
```
1776
1777
1778
1779
### 添加代表作视频
1780
1781
> http://api.bilibili.com/x/space/masterpiece/add
1782
1783
*方式：POST*
1784
1785
需要登录(SESSDATA)
1786
1787
代表作上限为3个稿件
1788
1789
**参数（ application/x-www-form-urlencoded ）：**
1790
1791
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
1792
| ------ | ---- | ------------------- | ------ | ------------------ |
1793
| aid | data | 置顶目标视频avID | 非必要 | avID与bvID任选一个 |
1794
| bvid | data | 置顶目标视频bvID | 非必要 | avID与bvID任选一个 |
1795
| reason | data | 代表作备注 | 非必要 | 置顶备注最大40字符 |
1796
| csrf | data | cookies中的bili_jct | 必要 | |
1797
1798
**json回复：**
1799
1800
根对象：
1801
1802
| 字段 | 类型 | 内容 | 备注 |
1803
| ------- | ---- | -------- | ------------------------------------------------------------ |
1804
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />53014：稿件已失效<br />53015：备注过长<br />53017：置顶非自己的稿件<br />53019：达到上限<br />53020：已经存在该稿件 |
1805
| message | str | 错误信息 | 默认为0 |
1806
| ttl | num | 1 | 作用尚不明确 |
1807
1808
**示例：**
1809
1810
添加视频`av94916552`/`BV1ZE411K7ux`到代表作列表
1811
1812
curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=94916552" "http://api.bilibili.com/x/space/masterpiece/add"
1813
1814
同curl -b "SESSDATA=xxx" -d "csrf=xxx&bvid=BV1ZE411K7ux" "http://api.bilibili.com/x/space/masterpiece/add"
1815
1816
```json
1817
{
1818
"code": 0,
1819
"message": "0",
1820
"ttl": 1
1821
}
1822
```
1823
1824
1825
1826
### 删除代表作视频
1827
1828
> http://api.bilibili.com/x/space/masterpiece/cancel
1829
1830
*方式：POST*
1831
1832
需要登录(SESSDATA)
1833
1834
**参数（ application/x-www-form-urlencoded ）：**
1835
1836
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
1837
| ------ | ---- | -------------------- | ------ | ------------------ |
1838
| aid | data | 要删除的目标视频avID | 非必要 | avID与bvID任选一个 |
1839
| bvid | data | 要删除的目标视频bvID | 非必要 | avID与bvID任选一个 |
1840
| csrf | data | cookies中的bili_jct | 必要 | |
1841
1842
**json回复：**
1843
1844
根对象：
1845
1846
| 字段 | 类型 | 内容 | 备注 |
1847
| ------- | ---- | -------- | ------------------------------------------------------------ |
1848
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />53021：置顶列表中没有该视频 |
1849
| message | str | 错误信息 | 默认为0 |
1850
| ttl | num | 1 | 作用尚不明确 |
1851
1852
**示例：**
1853
1854
删除置顶视频`av59765630`/`BV1Yt41137T6`
1855
1856
curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=59765630" "http://api.bilibili.com/x/space/masterpiece/cancel"
1857
1858
同curl -b "SESSDATA=xxx" -d "csrf=xxx&bvid=BV1Yt41137T6" "http://api.bilibili.com/x/space/masterpiece/cancel"
1859