mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2024-12-27 13:00:29 +08:00
276 lines
7.3 KiB
Markdown
276 lines
7.3 KiB
Markdown
# 电磁力相关
|
||
|
||
- [获取电磁力等级（web端）](#获取电磁力等级（web端）)
|
||
- [获取电磁力详细数值（双端）](#获取电磁力详细数值（双端）)
|
||
- [获取电磁力数值历史变化（双端）](#获取电磁力数值历史变化（双端）)
|
||
|
||
---
|
||
|
||
电磁力每周日下午刷新
|
||
|
||
## 获取电磁力等级（web端）
|
||
|
||
> http://member.bilibili.com/x/web/elec/user
|
||
|
||
*请求方式：GET*
|
||
|
||
认证方式：仅可Cookie（SESSDATA）
|
||
|
||
**json回复：**
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | -------- | ----------------------------- |
|
||
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
|
||
| message | str | 错误信息 | 默认为0 |
|
||
| ttl | num | 1 | |
|
||
| data | obj | 信息本体 | |
|
||
|
||
`data`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------ | ---- | ----------- | ---------------- |
|
||
| mid | num | 当前用户mid | |
|
||
| state | num | 电磁力等级 | |
|
||
| reason | str | 空 | **作用尚不明确** |
|
||
|
||
**示例：**
|
||
|
||
```shell
|
||
curl 'http://member.bilibili.com/x/web/elec/user' \
|
||
-b 'SESSDATA=xxx'
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例：</summary>
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"message": "0",
|
||
"ttl": 1,
|
||
"data": {
|
||
"mid": 293793435,
|
||
"state": 2,
|
||
"reason": ""
|
||
}
|
||
}
|
||
```
|
||
|
||
</details>
|
||
|
||
## 获取电磁力详细数值（双端）
|
||
|
||
> http://api.bilibili.com/studio/up-rating/rating/summary
|
||
|
||
*请求方式：GET*
|
||
|
||
认证方式：Cookie（SESSDATA）或APP
|
||
|
||
**url参数：**
|
||
|
||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||
| ---------- | ---- | ------------ | ----------- | ---- |
|
||
| access_key | str | APP登录Token | APP方式必要 | |
|
||
|
||
**json回复：**
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | ------- | ----------------------------- |
|
||
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
|
||
| message | str | 错误信息 | 默认为0 |
|
||
| ttl | num | 1 | |
|
||
| data | obj | 信息本体 | |
|
||
|
||
`data`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----------------- | ---- | -------------- | ---- |
|
||
| date | str | 数据刷新时间 | YYYY-MM-DD |
|
||
| level | obj | 电磁力等级 | |
|
||
| creative | obj | 创作力 | |
|
||
| influence | obj | 影响力 | |
|
||
| credit | obj | 信用分 | |
|
||
|
||
`data`中的`level` `creative` `influence` `credit`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| -------- | ---- | -------- | ---- |
|
||
| data | num | 数值 | |
|
||
| prev | num | ？？？ | **作用尚不明确** |
|
||
| desc | str | 描述 | |
|
||
| date | num | 刷新时间 | 时间戳 |
|
||
|
||
**示例：**
|
||
|
||
Cookie方式：
|
||
|
||
```shell
|
||
curl 'http://api.bilibili.com/studio/up-rating/rating/summary' \
|
||
-b 'SESSDATA=xxx'
|
||
```
|
||
|
||
APP方式：
|
||
|
||
```shell
|
||
curl -G 'http://api.bilibili.com/studio/up-rating/rating/summary' \
|
||
--data-urlencode 'access_key=xxx'
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例：</summary>
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"message": "0",
|
||
"ttl": 1,
|
||
"data": {
|
||
"date": "2020-07-05",
|
||
"level": {
|
||
"data": 1,
|
||
"prev": 0,
|
||
"desc": "正式开启创作之路，希望未来的路上我们携手相伴，创作更多优质内容~",
|
||
"date": 1593878400
|
||
},
|
||
"creative": {
|
||
"data": 39,
|
||
"prev": 39,
|
||
"desc": "考察近一年来的创作行为，良好的原创投稿行为和互动数据有助于提升创作力。",
|
||
"date": 1593878400
|
||
},
|
||
"influence": {
|
||
"data": 54,
|
||
"prev": 54,
|
||
"desc": "根据近一年活跃粉丝数据进行评估，良好的粉丝活跃度是影响力的基础。",
|
||
"date": 1593878400
|
||
},
|
||
"credit": {
|
||
"data": 100,
|
||
"prev": 100,
|
||
"desc": "良好的投稿记录将维持较高的信用分，违反投稿公约的行为将扣除信用分。",
|
||
"date": 1594106147
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
</details>
|
||
|
||
## 获取电磁力数值历史变化（双端）
|
||
|
||
> http://api.bilibili.com/studio/up-rating/rating/history
|
||
|
||
*请求方式：GET*
|
||
|
||
认证方式：Cookie（SESSDATA）或APP
|
||
|
||
**url参数：**
|
||
|
||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||
| ---------- | ---- | ------------ | ----------- | -------------- |
|
||
| access_key | str | APP登录Token | APP方式必要 | |
|
||
| type | num | 目标数据类型 | 必要 | 类型代码见下表 |
|
||
|
||
类型代码`type`：
|
||
|
||
| 代码 | 含义 |
|
||
| ---- | ------ |
|
||
| 1 | 创作力 |
|
||
| 2 | 影响力 |
|
||
| 3 | 信用分 |
|
||
|
||
**json回复：**
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | -------- | ------------------------------------------------- |
|
||
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
|
||
| message | str | 错误信息 | 默认为0 |
|
||
| ttl | num | 1 | |
|
||
| data | obj | 信息本体 | |
|
||
|
||
`data`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----- | ----- | ------------ | -------- |
|
||
| date | array | 数据记录时间 | 每周更新 |
|
||
| score | array | 电磁力等级 | 每周更新 |
|
||
|
||
`data`中的`date`数组：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | ----------------- | -------------- |
|
||
| 0 | str | 1周前的日期 | MM-DD |
|
||
| n | str | （n+1）周前的日期 | 与数值一一对应 |
|
||
| …… | str | …… | …… |
|
||
| 7 | str | 8周前的日期 | 最后一条 |
|
||
|
||
`data`中的`score`数组：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | ----------------- | -------------- |
|
||
| 0 | num | 1周前的数值 | |
|
||
| n | num | （n+1）周前的数值 | 与日期一一对应 |
|
||
| …… | num | …… | …… |
|
||
| 7 | num | 8周前的数值 | 最后一条 |
|
||
|
||
**示例：**
|
||
|
||
查询创作力的历史变化
|
||
|
||
Cookie方式：
|
||
|
||
```shell
|
||
curl -G 'http://api.bilibili.com/studio/up-rating/rating/history' \
|
||
--data-urlencode 'type=1' \
|
||
-b 'SESSDATA=xxx'
|
||
```
|
||
|
||
APP方式：
|
||
|
||
```shell
|
||
curl -G 'http://api.bilibili.com/studio/up-rating/rating/history' \
|
||
--data-urlencode 'type=1' \
|
||
--data-urlencode 'access_key=xxx'
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例：</summary>
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"message": "0",
|
||
"ttl": 1,
|
||
"data": {
|
||
"date": [
|
||
"05-17",
|
||
"05-24",
|
||
"05-31",
|
||
"06-07",
|
||
"06-14",
|
||
"06-21",
|
||
"06-28",
|
||
"07-05"
|
||
],
|
||
"score": [
|
||
48,
|
||
48,
|
||
49,
|
||
49,
|
||
49,
|
||
49,
|
||
49,
|
||
49
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
</details>
|