GitHub/mihoyo-api-collect
1
0
Fork 0
mirror of https://github.com/UIGF-org/mihoyo-api-collect.git synced 2025-12-12 08:58:12 +08:00
Code Issues Packages Projects Releases Wiki Activity

添加一些用户信息API

Browse Source
This commit is contained in:
Kamisato-Ayaka-233
2023-05-20 15:50:19 +08:00
parent 7317da7e53
commit 56556213f7
4 changed files with 430 additions and 50 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
hoyolab/user/game_account_info.md
View File

@@ -1795,7 +1795,7 @@ _请求方式：GET_
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| authkey_ver | num | 1 | |
| authkey | str | 验证密钥，用于标识游戏账号 | 打开“游戏安装目录/GenshinImpact_Data（或YuanShen_Data）/webCaches/Cache/Cache_Data/data_2”，寻找类似“<https://webstatic.mihoyo.com/genshin/event/e20190909gacha-v2/index.html……”（国服）或“https://webstatic-sea.hoyoverse.com/genshin/event/e20190909gacha-v2/index.html……”（国际服）的链接，该参数的值在其中> |
| authkey | str | 验证密钥，用于标识游戏账号 | 获取方法：<br>1. 游戏内打开一次跃迁记录页面，然后在“游戏安装目录/StarRail_Data/webCaches/Cache/Cache_Data/data_2”，寻找类似“<https://api-takumi.mihoyo.com/common/gacha_record/api/getGachaLog……>”的链接，该参数的值在其中<br>2. [通过Cookie获取用户`authkey`](hoyolab/user/info.md#通过cookie获取用户authkey) |
| lang | str | 语言，即返回数据中抽到的项目名称<br>zh-cn zh 简体中文<br>zh-tw 繁体中文<br>en-us en 英语<br>ru-ru ru 俄语<br>ja-jp ja 日语<br>以及其它国际语言代码 | |
| size | num | 返回数据中的最大数据数量。最小为0，最大为20。若小于0，则返回0个数据；若大于20，则返回最大20个数据 | |
| end_id | num | 见下文的说明 | |
@@ -1906,7 +1906,8 @@ _请求方式：GET_
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| server | str |
| role_id | num | 星穹铁道UID | |
| server | str | 服务器名称 | |
根对象：
@@ -2000,7 +2001,7 @@ _请求方式：GET_
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| authkey_ver | num | 1 | |
| authkey | str | 验证密钥，用于标识游戏账号 | 打开“游戏安装目录/StarRail_Data/webCaches/Cache/Cache_Data/data_2”，寻找类似“<https://api-takumi.mihoyo.com/common/gacha_record/api/getGachaLog……”的链接，该参数的值在其中> |
| authkey | str | 验证密钥，用于标识游戏账号 | 获取方法：<br>1. 游戏内打开一次跃迁记录页面，然后在“游戏安装目录/StarRail_Data/webCaches/Cache/Cache_Data/data_2”，寻找类似“<https://api-takumi.mihoyo.com/common/gacha_record/api/getGachaLog……>”的链接，该参数的值在其中<br>2. [通过Cookie获取用户`authkey`](hoyolab/user/info.md#通过cookie获取用户authkey) |
| lang | str | 语言，即返回数据中抽到的项目名称<br>zh-cn zh 简体中文<br>zh-tw 繁体中文<br>en-us en 英语<br>ru-ru ru 俄语<br>ja-jp ja 日语<br>以及其它国际语言代码 | |
| size | num | 返回数据中的最大数据数量。最小为0，最大为20。若小于0，则返回0个数据；若大于20，则返回最大20个数据 | |
| end_id | num | 见下文的说明 | |

371
hoyolab/user/info.md
View File

@@ -2,7 +2,376 @@
- [用户信息](#用户信息)
- [获取用户完整信息](#获取用户完整信息)
- [获取用户所有文章](#获取用户所有文章)
- [通过Cookie获取用户`authkey`](#通过cookie获取用户authkey)
---
# 获取用户完整信息
## 获取用户完整信息
**国服：**
_请求方式：GET_
`https://bbs-api.miyoushe.com/user/api/getUserFullInfo`
**参数：**
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| uid | num | 米游社账号ID | |
**JSON返回：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| retcode | num | 返回码<br>-20001 用户不存在 | |
| message | str | 返回消息 | |
| data | obj | 用户信息 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| user_info | obj | 该用户的详细信息 | |
| follow_relation | obj | 请求Cookie对应用户与该用户的关系 | |
| auth_relations | obj | 待调查 | 似乎总是都为空对象 |
| is_in_blacklist | bool | 是否被封禁 | |
| is_has_collection | bool | 是否拥有文章合集 | |
| is_creator | bool | false | |
| customer_service | obj | 客服工作人员信息 | |
| audit_info | obj | 昵称与简介的审核状态信息 | |
`data`对象→`user_info`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| uid | str | 该米游社用户的ID | |
| nickname | str | 昵称 | |
| introduce | str | 该用户的简介内容 | |
| avatar | str | 该用户的头像的ID | |
| gender | num | 该用户设置的性别<br>0 保密<br>1 男<br>2 女 | |
| certification | obj | 该用户获得的认证的信息 | |
| level_exps | arr | 该用户在每个论坛分区的等级 | |
| achieve | obj | 该用户的粉丝、关注、话题等信息 | |
| community_info | obj | 该用户在社区中的信息 | |
| avatar_url | str | 该用户头像的图片URL | |
| certifications | arr | 该用户得到的认证信息 | |
| level_exp | null | 待调查 | 似乎总是为空 |
| pendant | str | 该用户的头像框图片URL | |
| is_logoff | bool | 是否已注销 | |
| ip_region | str | 该用户的IP属地 | |
`data`对象→`user_info`对象→`certification`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| type | num | 认证类型<br>0 没有认证<br>1 官方认证<br>2 个人认证 | |
| label | str | 认证标签 | |
`data`对象→`user_info`对象→`level_exps`数组→对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| level | num | 在该分区的等级 | |
| exp | num | 在该分区的经验 | |
| game_id | num | 该论坛分区的ID | |
`data`对象→`user_info`对象→`achieve`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| like_num | str | 该用户获得的点赞数 | |
| post_num | str | 该用户发布的文章数 | |
| replypost_num | str | 该用户的转发文章数 | |
| follow_cnt | str | 关注的用户数 | |
| followed_cnt | str | 该用户的粉丝数 | |
| topic_cnt | str | 该用户的建立的话题数 | |
| new_follower_num | str | 待调查 | |
| good_post_num | str | 该用户的精选文章数 | |
| follow_collection_cnt | str | 该用户关注的文章合集数 | |
`data`对象→`user_info`对象→`community_info`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| is_realname | bool | true | |
| agree_status | bool | true | |
| silent_end_time | num | 禁言结束时间的Unix时间戳 | |
| forbid_end_time | num | 封禁结束时间的Unix时间戳 | |
| info_upd_time | num | 个人信息更新时间的时间戳，有时为年份 | |
| privacy_invisible | obj | 该用户的隐私可见性设置 | |
| notify_disable | obj | 该用户的通知屏蔽设置 | |
| has_initialized | bool | true | |
| user_func_status | obj | 该用户开启的功能 | |
| forum_silent_info | arr | 待调查 | |
| last_login_ip | str | 上次登录的IP | 总是为空字符串 |
| last_login_time | num | 上次登录时间的Unix时间戳 | 总是为0 |
| created_at | num | 用户注册时间的Unix时间戳 | |
`data`对象→`user_info`对象→`community_info`对象→`privacy_invisible`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| post | bool | 是否隐藏发布的文章 | |
| collect | bool | 是否隐藏收藏的文章 | |
| watermark | bool | 在评论和文章中的图片是否添加水印 | |
| reply | bool | 是否隐藏回复 | |
| post_and_instant | bool | 待调查 | |
`data`对象→`user_info`对象→`community_info`对象→`notify_disable`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| reply | bool | 是否屏蔽回复提醒 | |
| upvote | bool | 是否屏蔽点赞提醒 | |
| follow | bool | 是否屏蔽关注提醒 | |
| system | bool | 是否屏蔽系统信息 | |
| chat | bool | 是否屏蔽评论提醒 | |
`data`对象→`user_info`对象→`community_info`对象→`user_func_status`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| enable_history_view | bool | 是否开启历史记录 | |
| enable_recommend | bool | 是否开启推荐 | |
| enable_mention | bool | 是否开启@ | |
| user_center_view | num | 待调查 | |
`data`对象→`user_info`对象→`certifications`数组→对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| id | str | 该认证的ID | |
| certification_id | str | 0 | |
| type | num | 认证类型<br>1 官方认证<br>2 个人认证 | |
| label | str | 认证标签 | |
`data`对象→`follow_relation`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| is_following | bool | 是否已关注该用户 | 若未设置Cookie，则始终为false |
| is_followed | bool | 是否被该用户关注 | 若未设置Cookie，则始终为false |
`data`对象→`customer_service`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| is_customer_service_staff | bool | 是否是客服工作人员 | |
| game_id | num | 未知 | |
`data`对象→`audit_info`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| is_nickname_in_audit | bool | 昵称是否正在审核 | |
| nickname | str | 空字符串 | |
| is_introduce_in_audit | bool | 简介是否正在审核 | |
| introduce | str | 空字符串 | |
| nickname_status | num | 昵称状态<br>0 正常 | |
<details>
<summary>查看示例</summary>
```json
{
"retcode": 0,
"message": "OK",
"data": {
"user_info": {
"uid": "75379477",
"nickname": "提瓦特徒步团",
"introduce": "人类的本质是搬运工",
"avatar": "10013",
"gender": 0,
"certification": {
"type": 1,
"label": "官方认证：梦想是环游世界"
},
"level_exps": [
{
"level": 16,
"exp": 101229,
"game_id": 2
},
{
"level": 1,
"exp": 0,
"game_id": 8
},
{
"level": 1,
"exp": 0,
"game_id": 5
},
{
"level": 2,
"exp": 60,
"game_id": 1
},
{
"level": 1,
"exp": 0,
"game_id": 4
},
{
"level": 1,
"exp": 0,
"game_id": 3
},
{
"level": 1,
"exp": 0,
"game_id": 6
}
],
"achieve": {
"like_num": "38092256",
"post_num": "266",
"replypost_num": "1438",
"follow_cnt": "2",
"followed_cnt": "1000036",
"topic_cnt": "0",
"new_follower_num": "625674",
"good_post_num": "0",
"follow_collection_cnt": "0"
},
"community_info": {
"is_realname": true,
"agree_status": true,
"silent_end_time": 0,
"forbid_end_time": 0,
"info_upd_time": 2022,
"privacy_invisible": {
"post": false,
"collect": false,
"watermark": true,
"reply": false,
"post_and_instant": false
},
"notify_disable": {
"reply": false,
"upvote": false,
"follow": false,
"system": false,
"chat": false
},
"has_initialized": true,
"user_func_status": {
"enable_history_view": true,
"enable_recommend": true,
"enable_mention": true,
"user_center_view": 1
},
"forum_silent_info": [],
"last_login_ip": "",
"last_login_time": 0,
"created_at": 0
},
"avatar_url": "https://img-static.mihoyo.com/communityweb/avatar/avatar10013.png",
"certifications": [
{
"id": "120",
"certification_id": "0",
"type": 1,
"label": "梦想是环游世界"
}
],
"level_exp": null,
"pendant": "",
"is_logoff": false,
"ip_region": "上海"
},
"follow_relation": {
"is_following": true,
"is_followed": false
},
"auth_relations": [],
"is_in_blacklist": false,
"is_has_collection": false,
"is_creator": false,
"customer_service": {
"is_customer_service_staff": false,
"game_id": 0
},
"audit_info": {
"is_nickname_in_audit": false,
"nickname": "",
"is_introduce_in_audit": false,
"introduce": "",
"nickname_status": 0
}
}
}
```
</details>
## 获取用户所有文章
**国服：**
_请求方式：GET_
``
## 通过Cookie获取用户`authkey`
在请求例如获取用户的游戏抽卡记录等API时需要使用到`authkey`。
**国服：**
_请求方式：POST_
> _需要验证应用Cookie_
`https://api-takumi.miyoushe.com/account/auth/api/genAuthKey`
**JSON请求：**
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| game_biz | str | 米游社区域<br>bbs_cn 国服 | |
**JSON返回：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| retcode | num | 返回码<br>1002 请求体的`game_biz`字段不正确<br>-100 Cookie不正确 | |
| message | str | 返回消息 | |
| data | obj | `authkey`信息 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| sign_type | num | 2 | |
| authkey_ver | num | 1 | |
| authkey | str | `authkey` | |
<details>
<summary>查看示例</summary>
```json
{
"retcode": 0,
"message": "OK",
"data": {
"sign_type": 2,
"authkey_ver": 1,
"authkey": "..."
}
}
```
</details>
**国际服：**
`未知`