mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2025-02-23 01:10:10 +08:00
225 lines
112 KiB
HTML
225 lines
112 KiB
HTML
|
<!DOCTYPE html>
|
|||
|
<html lang="zh-CN">
|
|||
|
<head>
|
|||
|
<meta charset="utf-8">
|
|||
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|||
|
<meta name="generator" content="VuePress 2.0.0-beta.67">
|
|||
|
<style>
|
|||
|
:root {
|
|||
|
--c-bg: #fff;
|
|||
|
}
|
|||
|
html.dark {
|
|||
|
--c-bg: #22272e;
|
|||
|
}
|
|||
|
html, body {
|
|||
|
background-color: var(--c-bg);
|
|||
|
}
|
|||
|
</style>
|
|||
|
<script>
|
|||
|
const userMode = localStorage.getItem('vuepress-color-scheme');
|
|||
|
const systemDarkMode = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
|
|||
|
if (userMode === 'dark' || (userMode !== 'light' && systemDarkMode)) {
|
|||
|
document.documentElement.classList.toggle('dark', true);
|
|||
|
}
|
|||
|
</script>
|
|||
|
<link rel="icon" href="/logo2.jpg"><title>稿件观众操作 | BAC Document</title><meta name="description" content="社区开源的第三方哔哩哔哩 API 文档">
|
|||
|
<link rel="preload" href="/bilibili-API-collect/assets/style-a7819745.css" as="style"><link rel="stylesheet" href="/bilibili-API-collect/assets/style-a7819745.css">
|
|||
|
<link rel="modulepreload" href="/bilibili-API-collect/assets/app-6ef24849.js"><link rel="modulepreload" href="/bilibili-API-collect/assets/action.html-c589c8dd.js"><link rel="modulepreload" href="/bilibili-API-collect/assets/action.html-a8a90285.js"><link rel="modulepreload" href="/bilibili-API-collect/assets/fav-55c612b4.js"><link rel="prefetch" href="/bilibili-API-collect/assets/CONTRIBUTING.html-5d94bebf.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/index.html-0d1d246d.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/index.html-a1a3558c.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/splash.html-53855429.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/ver.html-b7ca0cfa.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/info.html-f7a47d1e.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/list.html-fecb6b5b.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/action.html-6c04cf4d.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/activity_list.html-b5ef105b.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/info.html-c42e4c4d.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/list.html-793787fd.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/recommend_author.html-3c1e94fe.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/action.html-ad3d1d10.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/articles.html-619e0082.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/category.html-c2e3b38d.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/info.html-0ee7d366.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/list.html-2e89a343.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/action.html-b93efa81.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/info.html-418558e4.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/music_list.html-02cb5f36.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/musicstream_url.html-0b86e281.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/rank.html-4e3c963c.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/status_number.html-3b1e7ab4.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/follow.html-c3918f68.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/info.html-c8498357.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/timeline.html-0a3a89de.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/videostream_url.html-ecea5d0c.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/banlist.html-66dae847.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/index.html-8ea2447b.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/video_room.html-6222ad7b.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/info.html-3698858a.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/videostream_url.html-0a0e9cbe.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/ip.html-298243ad.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/action.html-6aa7eeb7.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/list.html-2971c414.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/index.html-4a9bcc52.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/railgun.html-3eebb2b8.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/season.html-a8ef16a3.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/statistics_data.html-bb56dc74.js" as="script"><link rel="prefetch" href="/bilibili-API-collect/assets/upload.html-1fd73832.js" as="sc
|
|||
|
</head>
|
|||
|
<body>
|
|||
|
<div id="app"><!--[--><div class="theme-container"><!--[--><header class="navbar"><div class="toggle-sidebar-button" title="toggle sidebar" aria-expanded="false" role="button" tabindex="0"><div class="icon" aria-hidden="true"><span></span><span></span><span></span></div></div><span><a href="/bilibili-API-collect/" class=""><img class="logo" src="/bilibili-API-collect/logo2.jpg" alt="BAC Document"><span class="site-name can-hide">BAC Document</span></a></span><div class="navbar-items-wrapper" style=""><!--[--><!--]--><nav class="navbar-items can-hide"><!--[--><div class="navbar-item"><a href="/bilibili-API-collect/" class="" aria-label="首页"><!--[--><!--]--> 首页 <!--[--><!--]--></a></div><div class="navbar-item"><a href="/bilibili-API-collect/#🍴目录" class="" aria-label="目录"><!--[--><!--]--> 目录 <!--[--><!--]--></a></div><div class="navbar-item"><a href="/bilibili-API-collect/CONTRIBUTING.html" class="" aria-label="贡献指南"><!--[--><!--]--> 贡献指南 <!--[--><!--]--></a></div><div class="navbar-item"><div class="navbar-dropdown-wrapper"><button class="navbar-dropdown-title" type="button" aria-label="相关社群"><span class="title">相关社群</span><span class="arrow down"></span></button><button class="navbar-dropdown-title-mobile" type="button" aria-label="相关社群"><span class="title">相关社群</span><span class="right arrow"></span></button><ul style="display:none;" class="navbar-dropdown"><!--[--><li class="navbar-dropdown-item"><a class="external-link" href="http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=ympvb3LAPT-Ulu3ezhGqbkJ8zXMKImOX&authKey=z1KdkOdKO3wytN43m9K6On9nBtnDL4pAoD6VQHCipFBb9TasNDKuDHCmOE6TF3uc&noverify=0&group_code=191187164" rel="noopener noreferrer" target="_blank" aria-label="QQ交流群(综合技术交流)"><!--[--><!--]--> QQ交流群(综合技术交流) <span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">open in new window</span></span><!--[--><!--]--></a></li><li class="navbar-dropdown-item"><a class="external-link" href="https://t.me/bilibili_API_collect_community" rel="noopener noreferrer" target="_blank" aria-label="Telegram交流群(Github Bot推送)"><!--[--><!--]--> Telegram交流群(Github Bot推送) <span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">open in new window</span></span><!--[--><!--]--></a></li><!--]--></ul></div></div><div class="navbar-item"><a class="external-link" href="https://github.com/SocialSisterYi/bilibili-API-collect" rel="noopener noreferrer" target="_blank" aria-label="GitHub"><!--[--><!--]--> GitHub <span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">open in new window</span></span><!--[--><!--]--></a></div><!--]--></nav><!--[--><!--]--><button cl
|
|||
|
--data-urlencode <span class="token string">'aid=79677524'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'like=1'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'csrf=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>bvid方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">'https://api.bilibili.com/x/web-interface/archive/like'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'bvid=BV1uJ411r7hL'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'like=1'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'csrf=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
|
|||
|
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"0"</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"ttl"</span><span class="token operator">:</span> <span class="token number">1</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h3 id="点赞视频-app端" tabindex="-1"><a class="header-anchor" href="#点赞视频-app端" aria-hidden="true">#</a> 点赞视频(APP端)</h3><blockquote><p>https://app.bilibili.com/x/v2/view/like</p></blockquote><p><em>请求方式:POST</em></p><p>认证方式:仅可APP</p><p><strong>正文参数( application/x-www-form-urlencoded ):</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>access_key</td><td>str</td><td>APP 登录 Token</td><td>APP 方式必要</td><td></td></tr><tr><td>aid</td><td>num</td><td>稿件 avid</td><td>必要</td><td></td></tr><tr><td>like</td><td>num</td><td>操作方式</td><td>必要</td><td>0:点赞<br>1:取消赞</td></tr></tbody></table><p><strong>json回复:</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0:成功 <br>-101:账号未登录<br>-400:请求错误<br>-403: 账号异常<br>10003:不存在该稿件</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>ttl</td><td>num</td><td>1</td><td></td></tr><tr><td>data</td><td>obj</td><td>数据本体</td><td></td></tr></tbody></table><p><code>data</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>toast</td><td>str</td><td>提示信息内容</td><td></td></tr></tbody></table><p><strong>示例:</strong></p><p>点赞视频<code>av79677524</code></p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">'https://app.bilibili.com/x/v2/view/like'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'access_key=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'aid=79677524'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'like=0'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
|
|||
|
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"0"</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"ttl"</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"data"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
|
|||
|
<span class="token property">"toast"</span><span class="token operator">:</span> <span class="token string">"点赞收到!视频可能推荐哦"</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h3 id="判断视频近期是否被点赞-双端" tabindex="-1"><a class="header-anchor" href="#判断视频近期是否被点赞-双端" aria-hidden="true">#</a> 判断视频近期是否被点赞(双端)</h3><blockquote><p>https://api.bilibili.com/x/web-interface/archive/has/like</p></blockquote><p><em>请求方式:GET</em></p><p>认证方式:APP或Cookie(SESSDATA)</p><p>注: 这一 API 实际上只能判断出视频<strong>在近期内</strong>是否被点赞, 并不能判断出视频是否被点赞. 「近期」的定义不明, 但至少半年前点赞过的视频, 用这一接口获取到的结果就已经是 <code>0</code> 了. 参见 <a href="https://github.com/SocialSisterYi/bilibili-API-collect/issues/380" target="_blank" rel="noopener noreferrer">#380<span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">open in new window</span></span></a>.</p><p><strong>url参数:</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>access_key</td><td>str</td><td>APP 登录 Token</td><td>APP 方式必要</td><td></td></tr><tr><td>aid</td><td>num</td><td>稿件 avid</td><td>必要(可选)</td><td>avid 与 bvid 任选一个</td></tr><tr><td>bvid</td><td>str</td><td>稿件 bvid</td><td>必要(可选)</td><td>avid 与 bvid 任选一个</td></tr></tbody></table><p><strong>json回复:</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0:成功<br>-400:请求错误<br>-101:账号未登录</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>ttl</td><td>num</td><td>1</td><td></td></tr><tr><td>data</td><td>num</td><td>被点赞标志</td><td>0:未点赞<br>1:已点赞</td></tr></tbody></table><p><strong>示例:</strong></p><p>视频<code>av39330059</code>/<code>BV1Bt411z799</code>的状态为已点赞</p><p>avid方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token parameter variable">-G</span> <span class="token string">'https://api.bilibili.com/x/web-interface/archive/has/like'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'aid=39330059'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>bvid方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token parameter variable">-G</span> <span class="token string">'https://api.bilibili.com/x/web-interface/archive/has/like'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'bvid=BV1Bt411z799'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
|
|||
|
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"0"</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"ttl"</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"data"</span><span class="token operator">:</span> <span class="token number">1</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h2 id="点踩" tabindex="-1"><a class="header-anchor" href="#点踩" aria-hidden="true">#</a> 点踩</h2><h3 id="点踩视频-app端" tabindex="-1"><a class="header-anchor" href="#点踩视频-app端" aria-hidden="true">#</a> 点踩视频(App端)</h3><blockquote><p>https://app.biliapi.net/x/v2/view/dislike</p></blockquote><p><em>请求方式:POST</em></p><p>认证方式:仅可App</p><p><strong>正文参数( application/x-www-form-urlencoded ):</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>access_key</td><td>str</td><td>APP 登录 Token</td><td>必要</td><td></td></tr><tr><td>aid</td><td>num</td><td>视频 aid</td><td>必要</td><td></td></tr><tr><td>dislike</td><td>num</td><td>操作类型</td><td>必要</td><td>0:点踩<br>1:取消点踩</td></tr></tbody></table><p><strong>json回复:</strong></p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0:成功 <br>-101:账号未登录<br>-400:请求错误<br>-404:啥都木有<br> 65005:取消踩失败 未点踩过<br>65007:已踩过</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>ttl</td><td>num</td><td>1</td><td></td></tr></tbody></table><p><strong>示例:</strong></p><p>点踩视频</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token parameter variable">-L</span> <span class="token parameter variable">-X</span> POST <span class="token string">'https://app.biliapi.net/x/v2/view/dislike'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-H</span> <span class="token string">'Content-Type: application/x-www-form-urlencoded'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'access_key=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'aid=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'dislike=0'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>取消点踩</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token parameter variable">-L</span> <span class="token parameter variable">-X</span> POST <span class="token string">'https://app.biliapi.net/x/v2/view/dislike'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-H</span> <span class="token string">'Content-Type: application/x-www-form-urlencoded'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'access_key=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'aid=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'dislike=1'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><h2 id="投币" tabindex="-1"><a class="header-anchor" href="#投币" aria-hidden="true">#</a> 投币</h2><img src="/bilibili-API-collect/assets/coin-56bd2c69.svg" width="100" height="100"><h3 id="投币视频-web端" tabindex="-1"><a class="header-anchor" href="#投币视频-web端" aria-hidden="true">#</a> 投币视频(web端)</h3><blockquote><p>https://api.bilibili.com/x/web-interface/coin/add</p></blockquote><p><em>请求方式:POST</em></p><p>认证方式:仅可Cookie(SESSDATA)</p><p>需验证 Cookie 中<code>buvid3</code>字段存在且正常, 否则将导致触发风控</p><p><strong>正文参数( application/x-www-form-urlencoded ):</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>aid</td><td>num</td><td>稿件 avid</td><td>必要(可选)</td><td>avid 与 bvid 任选一个</td></tr><tr><td>bvid</td><td>str</td><td>稿件 bvid</td><td>必要(可选)</td><td>avid 与 bvid 任选一个</td></tr><tr><td>multiply</td><td>num</td><td>投币数量</td><td>必要</td><td>上限为2</td></tr><tr><td>select_like</td><td>num</td><td>是否附加点赞</td><td>非必要</td><td>0:不点赞<br>1:同时点赞<br>默认为0</td></tr><tr><td>csrf</td><td>str</td><td>CSRF Token(位于 Cookie)</td><td>必要</td><td></td></tr></tbody></table><p><strong>json回复:</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0:成功<br>-101:账号未登录<br>-102:账号被封停<br>-104:硬币不足<br>-111:csrf校验失败<br>-400:请求错误<br>-403: 账号异常<br>10003:不存在该稿件<br>34002:不能给自己投币<br>34003:非法的投币数量<br>34004:投币间隔太短<br>34005:超过投币上限</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>ttl</td><td>num</td><td>1</td><td></td></tr><tr><td>data</td><td>obj</td><td>信息本体</td><td></td></tr></tbody></table><p>data 对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>like</td><td>bool</td><td>是否点赞成功</td><td>true:成功<br>false:失败<br>已赞过则附加点赞失败</td></tr></tbody></table><p><strong>示例:</strong></p><p>为视频<code>av90671873</code>/<code>BV1N7411A7wC</code>投币2枚</p><p>avid方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">'https://api.bilibili.com/x/web-interface/coin/add'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'aid=90671873'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'select_like=1'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'multiply=2'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'csrf=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>bvid方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">'https://api.bilibili.com/x/web-interface/coin/add'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'bvid=BV1N7411A7wC'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'select_like=1'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'multiply=2'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'csrf=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
|
|||
|
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"0"</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"ttl"</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"data"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
|
|||
|
<span class="token property">"like"</span><span class="token operator">:</span> <span class="token boolean">true</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h3 id="投币视频-app端" tabindex="-1"><a class="header-anchor" href="#投币视频-app端" aria-hidden="true">#</a> 投币视频(APP端)</h3><blockquote><p>https://app.bilibili.com/x/v2/view/coin/add</p></blockquote><p><em>请求方式:POST</em></p><p>认证方式:仅可APP</p><p><strong>正文参数( application/x-www-form-urlencoded ):</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>access_key</td><td>str</td><td>APP 登录 Token</td><td>APP 方式必要</td><td></td></tr><tr><td>aid</td><td>num</td><td>稿件 avid</td><td>必要</td><td></td></tr><tr><td>multiply</td><td>num</td><td>投币数量</td><td>必要</td><td>上限为2</td></tr><tr><td>select_like</td><td>num</td><td>附加点赞</td><td>非必要</td><td>0:不点赞<br>1:同时点赞<br>默认为0</td></tr></tbody></table><p><strong>json回复:</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0:成功<br>-101:账号未登录<br>-102:账号被封停<br>-104:硬币不足<br>-400:请求错误<br>10003:不存在该稿件<br>34002:不能给自己投币<br>34003:非法的投币数量<br>34004:投币间隔太短<br>34005:超过投币上限</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>ttl</td><td>num</td><td>1</td><td></td></tr><tr><td>data</td><td>obj</td><td>信息本体</td><td></td></tr></tbody></table><p>data 对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>like</td><td>bool</td><td>是否点赞成功</td><td>true:成功<br>false:失败<br>已赞过则附加点赞失败</td></tr></tbody></table><p>为视频<code>av90671873</code>投币2枚</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">'https://app.bilibili.com/x/v2/view/coin/add'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'access_key=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'aid=90671873'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'select_like=1'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'multiply=2'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
|
|||
|
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"0"</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"ttl"</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"data"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
|
|||
|
<span class="token property">"like"</span><span class="token operator">:</span> <span class="token boolean">true</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h3 id="判断视频是否被投币-双端" tabindex="-1"><a class="header-anchor" href="#判断视频是否被投币-双端" aria-hidden="true">#</a> 判断视频是否被投币(双端)</h3><blockquote><p>https://api.bilibili.com/x/web-interface/archive/coins</p></blockquote><p><em>请求方式:GET</em></p><p>认证方式:APP或Cookie(SESSDATA)</p><p><strong>url参数:</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>access_key</td><td>str</td><td>APP 登录 Token</td><td>APP方式必要</td><td></td></tr><tr><td>aid</td><td>num</td><td>稿件 avid</td><td>必要(可选)</td><td>avid 与 bvid 任选一个</td></tr><tr><td>bvid</td><td>str</td><td>稿件 bvid</td><td>必要(可选)</td><td>avid 与 bvid 任选一个</td></tr></tbody></table><p><strong>json回复:</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0:成功<br>-400:请求错误<br>-101:账号未登录</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>ttl</td><td>num</td><td>1</td><td></td></tr><tr><td>data</td><td>obj</td><td>信息本体</td><td></td></tr></tbody></table><p><code>data</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>multiply</td><td>num</td><td>投币枚数</td><td>未投币为0</td></tr></tbody></table><p><strong>示例:</strong></p><p>视频<code>av37896701</code>/<code>BV18t411q7zz</code>的投币数为2枚</p><p>avid方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token parameter variable">-G</span> <span class="token string">'https://api.bilibili.com/x/web-interface/archive/coins'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'aid=37896701'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>bvid方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token parameter variable">-G</span> <span class="token string">'https://api.bilibili.com/x/web-interface/archive/coins'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'bvid=BV18t411q7zz'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
|
|||
|
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"0"</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"ttl"</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"data"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
|
|||
|
<span class="token property">"multiply"</span><span class="token operator">:</span> <span class="token number">2</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h2 id="收藏" tabindex="-1"><a class="header-anchor" href="#收藏" aria-hidden="true">#</a> 收藏</h2><img src="/bilibili-API-collect/assets/fav-e784befa.svg" width="100" height="100"><h3 id="收藏视频-双端" tabindex="-1"><a class="header-anchor" href="#收藏视频-双端" aria-hidden="true">#</a> 收藏视频(双端)</h3><blockquote><p>https://api.bilibili.com/medialist/gateway/coll/resource/deal</p></blockquote><p><em>请求方式:POST</em></p><p>认证方式:APP或Cookie(SESSDATA)</p><p>鉴权方式:Cookie方式时需要验证referer为 <code>.bilibili.com</code>域名下</p><p><strong>正文参数( application/x-www-form-urlencoded ):</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>access_key</td><td>str</td><td>APP 登录 Token</td><td>APP 方式必要</td><td></td></tr><tr><td>rid</td><td>num</td><td>稿件 avid</td><td>必要</td><td></td></tr><tr><td>type</td><td>num</td><td>必须为2</td><td>必要</td><td></td></tr><tr><td>add_media_ids</td><td>nums</td><td>需要加入的收藏夹 mlid</td><td>非必要(可选)</td><td>同时添加多个,用<code>,</code>(%2C)分隔</td></tr><tr><td>del_media_ids</td><td>nums</td><td>需要取消的收藏夹 mlid</td><td>非必要(可选)</td><td>同时取消多个,用<code>,</code>(%2C)分隔</td></tr><tr><td>csrf</td><td>str</td><td>CSRF Token(位于 Cookie)</td><td>Cookie 方式必要</td><td></td></tr></tbody></table><p><strong>json回复:</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0:成功<br>-101:账号未登录<br>-111:csrf校验失败<br>-400:请求错误<br>-403:访问权限不足<br>10003:不存在该稿件<br>11010: 您访问的内容不存在<br>11201:已经收藏过了<br>11202:已经取消收藏了<br>11203:达到收藏上限<br>72010017:参数错误</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>正确为success</td></tr><tr><td>data</td><td>obj</td><td>信息本体</td><td></td></tr></tbody></table><p><code>data</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>prompt</td><td>bool</td><td>是否为未关注用户收藏</td><td>false:否<br>true:是</td></tr></tbody></table><p><strong>示例:</strong></p><p>将视频<code>av49166435</code>添加到收藏夹<code>49166435</code>中</p><p>Cookie方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">'https://api.bilibili.com/medialist/gateway/coll/resource/deal'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'rid=90671873'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'type=2'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'add_media_ids=49166435'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'del_media_ids='</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'csrf=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-e</span> <span class="token string">'https://www.bilibili.com'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>APP方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">'https://api.bilibili.com/medialist/gateway/coll/resource/deal'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'access_key=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'rid=90671873'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'type=2'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'add_media_ids=49166435'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'del_media_ids='</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
|
|||
|
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"data"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
|
|||
|
<span class="token property">"prompt"</span><span class="token operator">:</span> <span class="token boolean">false</span>
|
|||
|
<span class="token punctuation">}</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"success"</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h3 id="收藏视频-web端" tabindex="-1"><a class="header-anchor" href="#收藏视频-web端" aria-hidden="true">#</a> 收藏视频(Web端)</h3><blockquote><p>https://api.bilibili.com/x/v3/fav/resource/deal</p></blockquote><p><em>请求方式: POST</em></p><p>认证方式: Cookie(SESSDATA)</p><p><strong>正文参数(application/x-www-form-urlencoded):</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>rid</td><td>num</td><td>稿件 avid</td><td>必要</td><td></td></tr><tr><td>type</td><td>num</td><td>必须为2</td><td>必要</td><td></td></tr><tr><td>add_media_ids</td><td>nums</td><td>需要加入的收藏夹 mlid</td><td>非必要(可选)</td><td>同时添加多个,用<code>,</code>(%2C)分隔</td></tr><tr><td>del_media_ids</td><td>nums</td><td>需要取消的收藏夹 mlid</td><td>非必要(可选)</td><td>同时取消多个,用<code>,</code>(%2C)分隔</td></tr><tr><td>csrf</td><td>str</td><td>CSRF Token (即 Cookie 中 bili_jct)</td><td>必要</td><td></td></tr><tr><td>platform</td><td>str</td><td>平台标识?</td><td>非必要</td><td>web端: web</td></tr><tr><td>eab_x</td><td>num</td><td>1</td><td>非必要</td><td>作用尚不明确</td></tr><tr><td>ramval</td><td>num</td><td>正整数</td><td>非必要</td><td>可能与在该页面的停留时间相关?</td></tr><tr><td>ga</td><td>num</td><td>1</td><td>非必要</td><td>作用尚不明确</td></tr><tr><td>gaia_source</td><td>str</td><td>???</td><td>非必要</td><td>web端: web_normal</td></tr></tbody></table><p><strong>JSON回复:</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0: 成功<br>-101: 账号未登录<br>-111: csrf 校验失败<br>2001000: 参数错误</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>ttl</td><td>num</td><td>1</td><td></td></tr><tr><td>data</td><td>obj</td><td>信息本体</td><td>错误时为 null 或不存在</td></tr></tbody></table><p><code>data</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>prompt</td><td>bool</td><td>是否为未关注用户收藏?</td><td>false:否<br>true:是</td></tr><tr><td>ga_data</td><td>null</td><td></td><td>作用尚不明确</td></tr><tr><td>toast_msg</td><td>str</td><td>空</td><td>作用尚不明确</td></tr><tr><td>success_num</td><td>num</td><td>0</td><td>作用尚不明确</td></tr></tbody></table><p><strong>示例:</strong></p><p>将视频 <code>av1906473802</code> 添加到收藏夹 <code>1164192068</code> 中</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token parameter variable">-sX</span> POST <span class="token string">"https://api.bilibili.com/x/v3/fav/resource/deal"</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">"rid=1906473802"</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">"type=2"</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">"csrf=xxx"</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">"add_media_ids=1164192068"</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">"SESSDATA=xxx; bili_jct=xxx"</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
|
|||
|
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"0"</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"ttl"</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"data"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
|
|||
|
<span class="token property">"prompt"</span><span class="token operator">:</span> <span class="token boolean">false</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"ga_data"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"toast_msg"</span><span class="token operator">:</span> <span class="token string">""</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"success_num"</span><span class="token operator">:</span> <span class="token number">0</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h3 id="判断视频是否被收藏-双端" tabindex="-1"><a class="header-anchor" href="#判断视频是否被收藏-双端" aria-hidden="true">#</a> 判断视频是否被收藏(双端)</h3><blockquote><p>https://api.bilibili.com/x/v2/fav/video/favoured</p></blockquote><p><em>请求方式:GET</em></p><p>认证方式:APP或Cookie(SESSDATA)</p><p><strong>url参数:</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>access_key</td><td>str</td><td>APP 登录 Token</td><td>APP 方式必要</td><td></td></tr><tr><td>aid</td><td>num 或 str</td><td>稿件 avid 或稿件 bvid</td><td>必要</td><td></td></tr></tbody></table><p><strong>json回复:</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0:成功<br>-400:请求错误<br>-101:账号未登录</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>ttl</td><td>num</td><td>1</td><td></td></tr><tr><td>data</td><td>obj</td><td>信息本体</td><td></td></tr></tbody></table><p>data 对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>count</td><td>num</td><td>1</td><td>作用尚不明确</td></tr><tr><td>favoured</td><td>bool</td><td>是否收藏</td><td>true:已收藏<br>false:未收藏</td></tr></tbody></table><p><strong>示例:</strong></p><p>视频<code>av46281123</code>/<code>BV1Bb411H7Dv</code>的状态为已收藏</p><p>avid方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token parameter variable">-G</span> <span class="token string">'https://api.bilibili.com/x/v2/fav/video/favoured'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'aid=46281123'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>bvid方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token parameter variable">-G</span> <span class="token string">'https://api.bilibili.com/x/v2/fav/video/favoured'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'aid=BV1Bb411H7Dv'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
|
|||
|
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"0"</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"ttl"</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"data"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
|
|||
|
<span class="token property">"count"</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"favoured"</span><span class="token operator">:</span> <span class="token boolean">true</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h2 id="一键三连" tabindex="-1"><a class="header-anchor" href="#一键三连" aria-hidden="true">#</a> 一键三连</h2><p><img src="/bilibili-API-collect/assets/like-10f92194.svg" align="left" width="50" height="50"><img src="/bilibili-API-collect/assets/coin-56bd2c69.svg" align="left" width="50" height="50"><img src="/bilibili-API-collect/assets/fav-e784befa.svg" width="50" height="50"></p><h3 id="一键三连视频-web端" tabindex="-1"><a class="header-anchor" href="#一键三连视频-web端" aria-hidden="true">#</a> 一键三连视频(web端)</h3><blockquote><p>https://api.bilibili.com/x/web-interface/archive/like/triple</p></blockquote><p><em>请求方式:POST</em></p><p>认证方式:仅可Cookie(SESSDATA)</p><p>同时点赞投币收藏视频,收藏于默认收藏夹中</p><p>需验证 Cookie 中<code>buvid3</code>字段存在且正常, 否则将导致触发风控</p><p><strong>正文参数( application/x-www-form-urlencoded ):</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>aid</td><td>num</td><td>稿件 avid</td><td>必要(可选)</td><td>avid 与 bvid 任选一个</td></tr><tr><td>bvid</td><td>str</td><td>稿件 bvid</td><td>必要(可选)</td><td>avid 与 bvid 任选一个</td></tr><tr><td>csrf</td><td>str</td><td>CSRF Token(位于 Cookie)</td><td>必要</td><td></td></tr></tbody></table><p><strong>json回复:</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0:成功<br>-101:账号未登录<br>-111:csrf校验失败<br>-400:请求错误<br>10003:不存在该稿件<br>-403: 账号异常</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>ttl</td><td>num</td><td>1</td><td></td></tr><tr><td>data</td><td>obj</td><td>信息本体</td><td></td></tr></tbody></table><p><code>data</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>like</td><td>bool</td><td>是否点赞成功</td><td>true:成功<br>false:失败</td></tr><tr><td>coin</td><td>bool</td><td>是否投币成功</td><td>true:成功<br>false:失败</td></tr><tr><td>fav</td><td>bool</td><td>是否收藏成功</td><td>true:成功<br>false:失败</td></tr><tr><td>multiply</td><td>num</td><td>投币枚数</td><td>默认为2</td></tr></tbody></table><p><strong>示例:</strong></p><p>将视频<code>av91003840</code>/<code>BV1Wj411f79U</code>一键三连</p><p>avid方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">'https://api.bilibili.com/x/web-interface/archive/like/triple'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'aid=91003840'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'csrf=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>bvid方式:</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">'https://api.bilibili.com/x/web-interface/archive/like/triple'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'bvid=BV1Wj411f79U'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'csrf=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
<span class="token parameter variable">-b</span> <span class="token string">'SESSDATA=xxx'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
|
|||
|
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"0"</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"ttl"</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"data"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
|
|||
|
<span class="token property">"like"</span><span class="token operator">:</span> <span class="token boolean">true</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"coin"</span><span class="token operator">:</span> <span class="token boolean">true</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"fav"</span><span class="token operator">:</span> <span class="token boolean">true</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"multiply"</span><span class="token operator">:</span> <span class="token number">2</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h3 id="一键三连视频-app端" tabindex="-1"><a class="header-anchor" href="#一键三连视频-app端" aria-hidden="true">#</a> 一键三连视频(APP端)</h3><blockquote><p>https://app.bilibili.com/x/v2/view/like/triple</p></blockquote><p><em>请求方式:POST</em></p><p>认证方式:仅可APP</p><p>同时点赞投币收藏视频,收藏于默认收藏夹中</p><p><strong>正文参数( application/x-www-form-urlencoded ):</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>access_key</td><td>str</td><td>APP 登录 Token</td><td>APP 方式必要</td><td></td></tr><tr><td>aid</td><td>num</td><td>稿件 avid</td><td>必要</td><td></td></tr></tbody></table><p><strong>json回复:</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0:成功<br>-101:账号未登录<br>-400:请求错误<br>10003:不存在该稿件</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>ttl</td><td>num</td><td>1</td><td></td></tr><tr><td>data</td><td>obj</td><td>信息本体</td><td></td></tr></tbody></table><p><code>data</code>对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>like</td><td>bool</td><td>是否点赞成功</td><td>true:成功<br>false:失败</td></tr><tr><td>coin</td><td>bool</td><td>是否投币成功</td><td>true:成功<br>false:失败</td></tr><tr><td>fav</td><td>bool</td><td>是否收藏成功</td><td>true:成功<br>false:失败</td></tr><tr><td>multiply</td><td>num</td><td>投币枚数</td><td>默认为2</td></tr></tbody></table><p><strong>示例:</strong></p><p>将视频<code>av91003840</code>一键三连</p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">'https://app.bilibili.com/x/v2/view/like/triple'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'access_key=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'aid=91003840'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
|
|||
|
<span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"0"</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"ttl"</span><span class="token operator">:</span> <span class="token number">1</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"data"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
|
|||
|
<span class="token property">"like"</span><span class="token operator">:</span> <span class="token boolean">true</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"coin"</span><span class="token operator">:</span> <span class="token boolean">true</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"fav"</span><span class="token operator">:</span> <span class="token boolean">true</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"multiply"</span><span class="token operator">:</span> <span class="token number">2</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details><h2 id="分享" tabindex="-1"><a class="header-anchor" href="#分享" aria-hidden="true">#</a> 分享</h2><h3 id="分享视频-web端" tabindex="-1"><a class="header-anchor" href="#分享视频-web端" aria-hidden="true">#</a> 分享视频 (Web端)</h3><blockquote><p>https://api.bilibili.com/x/web-interface/share/add</p></blockquote><p><em>请求方式:POST</em></p><p><strong>正文参数( application/x-www-form-urlencoded ):</strong></p><table><thead><tr><th>参数名</th><th>类型</th><th>内容</th><th>必要性</th><th>备注</th></tr></thead><tbody><tr><td>aid</td><td>num</td><td>稿件 avid</td><td>必要(可选)</td><td>avid 与 bvid 任选一个</td></tr><tr><td>bvid</td><td>str</td><td>稿件 bvid</td><td>必要(可选)</td><td>avid 与 bvid任 选一个</td></tr><tr><td>csrf</td><td>str</td><td>CSRF Token(位于 Cookie)</td><td>必要</td><td></td></tr></tbody></table><p><strong>json回复:</strong></p><p>根对象:</p><table><thead><tr><th>字段</th><th>类型</th><th>内容</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>num</td><td>返回值</td><td>0:成功<br>-101:账号未登录<br>-111:csrf校验失败<br>-400:请求错误</td></tr><tr><td>message</td><td>str</td><td>错误信息</td><td>默认为0</td></tr><tr><td>ttl</td><td>num</td><td>1</td><td></td></tr><tr><td>data</td><td>num</td><td>当前分享数</td><td></td></tr></tbody></table><p><strong>示例:</strong></p><p>分享视频<code>BV1oA411776z</code></p><div class="language-bash line-numbers-mode" data-ext="sh"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token string">'https://api.bilibili.com/x/web-interface/share/add'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'csrf=xxx'</span> <span class="token punctuation">\</span>
|
|||
|
--data-urlencode <span class="token string">'bvid=BV1oA411776z'</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><details><summary>查看响应示例:</summary><div class="language-json line-numbers-mode" data-ext="json"><pre class="language-json"><code><span class="token punctuation">{</span>
|
|||
|
<span class="token property">"code"</span><span class="token operator">:</span><span class="token number">0</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"message"</span><span class="token operator">:</span><span class="token string">"0"</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"ttl"</span><span class="token operator">:</span><span class="token number">1</span><span class="token punctuation">,</span>
|
|||
|
<span class="token property">"data"</span><span class="token operator">:</span><span class="token number">19</span>
|
|||
|
<span class="token punctuation">}</span>
|
|||
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div></details></div><!--[--><!--]--></div><footer class="page-meta"><div class="meta-item edit-link"><a class="external-link meta-item-label" href="https://github.com/SocialSisterYi/bilibili-API-collect/edit/master/docs/video/action.md" rel="noopener noreferrer" target="_blank" aria-label="在 GitHub 上编辑此页"><!--[--><!--]--> 在 GitHub 上编辑此页 <span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">open in new window</span></span><!--[--><!--]--></a></div><!----><!----></footer><!----><!--[--><!--[--><footer style="text-align:center;"> Copyright © 2020-2024 <a href="https://github.com/SocialSisterYi/">SocialSisterYi</a> | <a href="https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/LICENSE">CC-BY-NC-4.0 Licensed</a></footer><!--]--><!--]--></main><!--]--></div><!----><!--]--></div>
|
|||
|
<script type="module" src="/bilibili-API-collect/assets/app-6ef24849.js" defer></script>
|
|||
|
</body>
|
|||
|
</html>
|