PaiGramTeam/mihoyo-api-collect
3
0
Fork 0
mirror of https://github.com/PaiGramTeam/mihoyo-api-collect.git synced 2024-11-25 09:37:27 +00:00
Code Issues Packages Projects Releases Wiki Activity
bb852e33b0
mihoyo-api-collect/hoyolab/user/info.md
Kamisato-Ayaka-233 a5876bcd10 - 【F】增加扫码登录获取Game Token的方法与接口 
- 【F】补全账号Cookie的获取方式
- 【F】增加Cookie字段
- 【I】修改请求头描述
- 【I】更改部分文档中错误的目录结构
2023-06-17 13:36:05 +08:00

10 KiB
Raw Blame History

用户基本信息

用户信息

获取用户完整信息

国服：

请求方式：GET

https://bbs-api.miyoushe.com/user/api/getUserFullInfo

参数：

字段 类型 内容 备注
uid num 米游社账号ID
gids num 论坛分区ID 可选，决定data对象→user_info对象→level_exp对象的内容

JSON返回：

根对象：

字段 类型 内容 备注
retcode num 返回码
-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 该用户设置的性别
0 保密
1 男
2 女
certification obj 该用户获得的认证的信息
level_exps arr 该用户在每个论坛分区的等级信息
achieve obj 该用户的粉丝、关注、话题等信息
community_info obj 该用户在社区中的信息
avatar_url str 该用户头像的图片URL
certifications arr 该用户得到的认证信息
level_exp null 该用户在参数gids对应论坛分区的等级信息 若没有传递gids参数，则为空对象
pendant str 该用户的头像框图片URL
is_logoff bool 是否已注销
ip_region str 该用户的IP属地

data对象→user_info对象→certification对象：

字段 类型 内容 备注
type num 认证类型
0 没有认证
1 官方认证
2 个人认证
label str 认证标签

data对象→user_info对象→level_exp对象：

字段 类型 内容 备注
level num 在该分区的等级
exp num 在该分区的经验
game_id num 该论坛分区的ID

data对象→user_info对象→level_exps数组→对象：

与data对象→user_info对象→level_exp对象的结构相同

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 认证类型
1 官方认证
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 昵称状态
0 未知
1 正常
2 昵称审核中
查看示例 
{
  "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
    }
  }
}

获取用户发布的文章

国服：

请求方式：GET

网页：https://bbs-api.miyoushe.com/post/wapi/userPost 应用：https://bbs-api.miyoushe.com/painter/api/user_instant/list

参数：

字段 类型 内容 备注
size num 获取的文章数量
uid num 米游社用户ID

JSON返回：

根对象：

字段 类型 内容 备注