mirror of https://github.com/PaiGramTeam/mihoyo-api-collect.git synced 2024-11-23 00:01:43 +00:00

Kamisato-Ayaka-233 94d9ad14f1 添加错误码分类

修改API的请求头和Cookie标识

2023-06-03 14:49:06 +08:00

12 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返回：

根对象：

字段	类型	内容	备注

通过Cookie获取账号`authkey`A

国服：

请求方式：POST

需要验证Cookie

SToken

https://api-takumi.miyoushe.com/account/auth/api/genAuthKey

JSON请求：

字段	类型	内容	备注
game_biz	str	米游社区域 bbs_cn 国服

JSON返回：

根对象：

字段	类型	内容
retcode	num	返回码 1002 请求体的`game_biz`字段不正确
message	str	返回消息
data	obj	`authkey`信息

data对象：

字段	类型	内容
sign_type	num	2
authkey_ver	num	1
authkey	str	`authkey`A

查看示例

{
  "retcode": 0,
  "message": "OK",
  "data": {
    "sign_type": 2,
    "authkey_ver": 1,
    "authkey": "..."
  }
}

国际服：

未知

通过Cookie获取账号`authkey`B

在请求例如获取用户的游戏抽卡记录等API时需要使用到authkeyB。

国服：

请求方式：POST

需要验证请求头

x-rpc-client_type：2 LKsalt DS1

需要验证Cookie

SToken

https://api-takumi.miyoushe.com/binding/api/genAuthKey

JSON请求：

字段	类型	内容	备注
game_biz	str	获取的`authkey`B的游戏 hk4e_cn 《原神》 hkrpg_cn 《崩坏：星穹铁道》
game_uid	num	游戏

JSON返回：

根对象：

字段	类型	内容
retcode	num	返回码 1002 请求体的`game_biz`字段不正确
message	str	返回消息
data	obj	`authkey`信息

data对象：

字段	类型	内容
sign_type	num	2
authkey_ver	num	1
authkey	str	`authkey`B

查看示例

{
  "retcode": 0,
  "message": "OK",
  "data": {
    "sign_type": 2,
    "authkey_ver": 1,
    "authkey": "..."
  }
}

国际服：

未知

12 KiB Raw Blame History Unescape Escape

用户基本信息

获取用户完整信息

获取用户发布的文章

通过Cookie获取账号authkeyA

通过Cookie获取账号authkeyB

12 KiB

Raw Blame History

通过Cookie获取账号`authkey`A

通过Cookie获取账号`authkey`B