diff --git a/README.md b/README.md index b08dcf9..b755092 100644 --- a/README.md +++ b/README.md @@ -106,7 +106,7 @@ - [创作中心](creativecenter) - [统计与数据](creativecenter/statistics&data.md)x - 列表查询相关 - - 电磁力相关 + - [电磁力数据](creativecenter/railgun.md)√ - [实时广播](broadcast) - [总则](broadcast/general.md)√ - [视频内广播](broadcast/video_room.md)√ diff --git a/creativecenter/railgun.md b/creativecenter/railgun.md index af2c5ae..0b909cd 100644 --- a/creativecenter/railgun.md +++ b/creativecenter/railgun.md @@ -1,12 +1,56 @@ # 电磁力相关 -本页所有操作均需登录(SESSDATA) +**本页所有操作均需登录(SESSDATA)** 电磁力每周日下午刷新 -## 获取电磁力数据 +## 获取电磁力等级 -> +> http://member.bilibili.com/x/web/elec/user + +*方式:GET* + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ----------------------------- | +| code | num | 返回值 | 0:成功
-101:账号未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | **作用尚不明确** | +| data | obj | 信息本体 | | + +`data`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | ----------- | ---------------- | +| mid | num | 当前用户UID | | +| state | num | 电磁力等级 | | +| reason | str | 空 | **作用尚不明确** | + +**示例:** + +http://member.bilibili.com/x/web/elec/user + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 293793435, + "state": 2, + "reason": "" + } +} +``` + + + +## 获取电磁力详细数值 + +> http://api.bilibili.com/studio/up-rating/rating/summary *方式:GET* @@ -18,14 +62,14 @@ | ------- | ---- | ------- | ----------------------------- | | code | num | 返回值 | 0:成功
-101:账号未登录 | | message | str | 错误信息 | 默认为0 | -| ttl | num | 1 | 作用尚不明确 | +| ttl | num | 1 | **作用尚不明确** | | data | obj | 信息本体 | | `data`对象: | 字段 | 类型 | 内容 | 备注 | | ----------------- | ---- | -------------- | ---- | -| date | str | 刷新时间 | | +| date | str | 数据刷新时间 | YYYY-MM-DD | | level | obj | 电磁力等级 | | | creative | obj | 创作力 | | | influence | obj | 影响力 | | @@ -36,12 +80,14 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | -------- | ---- | | data | num | 数值 | | -| prev | num | 尚不明确 | | -| desc | num | 描述 | | -| date | num | 刷新时间 | | +| prev | num | ??? | **作用尚不明确** | +| desc | str | 描述 | | +| date | num | 刷新时间 | 时间戳 | **示例:** +http://api.bilibili.com/studio/up-rating/rating/summary + ```json { "code": 0, @@ -76,3 +122,98 @@ } } ``` + + + +## 获取电磁力数值历史变化 + +> http://api.bilibili.com/studio/up-rating/rating/history + +*方式:GET* + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ------------ | ------ | -------------- | +| type | num | 目标数据类型 | 必要 | 类型代码见下表 | + +类型代码`type`: + +| 代码 | 含义 | +| ---- | ------ | +| 1 | 创作力 | +| 2 | 影响力 | +| 3 | 信用分 | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------- | +| code | num | 返回值 | 0:成功
-101:账号未登录
-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周前的数值 | 最后一条 | + +**示例:** + +查询创作力的历史变化 + + http://api.bilibili.com/studio/up-rating/rating/history?type=1 + +```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 + ] + } +} +``` +