PaiGramTeam/mihoyo-api-collect
3
0
Fork 0
mirror of https://github.com/PaiGramTeam/mihoyo-api-collect.git synced 2024-11-26 09:53:38 +00:00
Code Issues Packages Projects Releases Wiki Activity
94d9ad14f1
mihoyo-api-collect/hoyolab/article/article.md
Kamisato-Ayaka-233 94d9ad14f1 添加错误码分类 
修改API的请求头和Cookie标识
2023-06-03 14:49:06 +08:00

22 KiB
Raw Blame History

论坛文章

获取首页信息

请求方式：GET

https://bbs-api-static.miyoushe.com/apihub/wapi/webHome

参数：

字段 类型 内容 备注
gids num 游戏ID
page num 页数 若未指定则为第1页
page_size num 每页文章数量，范围为1-50 若未指定或超出范围则为每页20篇

JSON返回：

根对象：

字段 类型 内容 备注
retcode num 返回码
1 未选择游戏
message str 返回消息
data obj 首页信息

data对象：

字段 类型 内容 备注
carousels arr 头部切换的横幅信息 网页端
recommended_posts arr 首页推荐文章
recommended_topics obj 首页推荐话题
fixed_posts arr 首页固定文章
selection_post_list arr 首页每月热榜

data对象→carousels数组→对象：

字段 类型 内容 备注
cover str 横幅图片
path str 横幅跳转链接

data对象→recommended_posts数组→对象：

字段 类型 内容 备注
post obj 文章信息
forum obj 所属分区信息
topics arr 文章话题信息
user obj 文章发布者信息
self_operation 待调查
stat obj 文章数据 均为0
请使用：获取完整文章信息
cover obj 文章封面信息
image_list arr 文章中每张图片的信息
is_official_master bool 待调查
is_user_master bool 待调查
help_sys obj 待调查
vote_count num 文章点赞数量 为0
请使用：获取完整文章信息
last_modify_time num 待调查
recommend_type num 待调查
collection obj 所属合集信息 为null
请使用：获取完整文章信息
vod_list 文章中每个视频的信息

data对象→recommended_posts数组→对象→post对象：

字段 类型 内容 备注
game_id num 游戏ID
post_id num 文章ID
f_forum_id num 所属分区ID
uid num 文章发布者的UID
subject str 文章标题
content str 简略的文章内容 获取完整内容请使用：获取完整文章信息
cover str 封面链接
view_type num 待调查
created_at num 文章创建的Unix时间戳
images arr 文章中每张图片的链接
post_status obj 文章状态数据
topic_ids arr 文章的话题的ID
view_status num 待调查
max_floor num 待调查
is_original num 是否是原创文章
1 原创
republish_authorization num 文章转载授权
2 已开启创作声明，允许规范转载
reply_time str 文章评论时间
is_deleted num 文章是否已删除
0 未删除
is_interactive bool 文章是否可交互（点赞、评论等）
score num 待调查

data对象→recommended_posts数组→对象→post对象→post_status对象：

字段 类型 内容 备注
is_top bool 文章是否置顶
is_good bool 是否是精华文章
is_official bool 是否是官方发布的文章

data对象→recommended_posts数组→对象→forum对象：

字段 类型 内容 备注
id num 文章所属分区的ID
name str 文章所属分区的名称

data对象→recommended_posts数组→对象→topics数组→对象：

字段 类型 内容 备注
id num 话题ID
name str 话题名称
cover str 话题封面
content_type num 待调查

data对象→recommended_posts数组→对象→user对象：

字段 类型 内容 备注
uid str 文章发布者的UID
nickname str 文章发布者的名称
introduce str 文章发布者的简介
avatar num 头像ID
certification obj 认证信息
level_exp obj 等级和经验信息
avatar_url str 头像链接
pendant str 头像框链接
is_following bool 是否关注了你 需要鉴权，未鉴权则为false
is_followed bool 是否已关注 需要鉴权，未鉴权则为false

data对象→recommended_posts数组→对象→stat对象：

字段 类型 内容 备注
reply_num num 评论数量 为0
view_num num 观看数量 为0
like_num num 点赞数量 为0
bookmark_num num 收藏数量 为0

data对象→recommended_posts数组→对象→cover对象：

字段 类型 内容 备注
url str 文章封面链接
height num 文章封面高度
width num 文章封面宽度
format str 文章封面文件扩展名
size str 文章封面文件大小 字节
crop 待调查
is_user_set_cover bool 是否是作者设置的封面
image_id str 图片ID
entity_type str 待调查
entity_id str 待调查

data对象→recommended_posts数组→对象→image_list对象：

字段 类型 内容 备注
url str 文章封面链接
height num 文章封面高度
width num 文章封面宽度
format str 文章封面文件扩展名
size str 文章封面文件大小 字节
crop 待调查
is_user_set_cover bool false
image_id str 图片ID
entity_type str 待调查
entity_id str 待调查

data对象→recommended_posts数组→对象→vod_list数组→对象：

字段 类型 内容 备注
id str 视频ID
duration num 视频时长 毫秒
cover str 视频封面链接
resolutions arr 视频分辨率列表
view_num num 视频播放数
transcoding_status num 待调查
review_status num 待调查

data对象→recommended_posts数组→对象→vod_list数组→对象→resolutions数组→对象：

字段 类型 内容 备注
url str 该清晰度的视频链接
definition str 清晰度文本
height num 该清晰度的视频的高度
width num 该清晰度的视频的宽度
bitrate num 该清晰度的视频的码率 未知单位
size str 该清晰度的视频的大小 字节
format str 该清晰度的视频的格式
label str 清晰度文本

data对象→recommended_topics对象：

字段 类型 内容 备注
list arr 话题信息
position num 推荐话题的位置

data对象→recommended_topics对象→list数组→对象：

字段 类型 内容 备注
id num 话题ID
name str 话题名称
cover str 话题封面链接
desc str 话题描述 为空字符串
is_focus bool 是否关注该话题 始终为false
view_num num 话题观看数 为0
discuss_num num 话题讨论数 为0

data对象→selection_post_list数组→对象：

字段 类型 内容 备注
post_id str 文章ID
subject str 文章标题
forum_id num 所属论坛的ID
forum_name str 所属论坛的名称
banner str 文章封面链接
view_type num 待调查
查看示例 
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "carousels": [
      {
        "cover": "https://upload-bbs.miyoushe.com/upload/2023/01/29/834af3e4eda5251e6082750fc22edb63_8777643204760273855.png",
        "path": "https://webstatic.mihoyo.com/ys/event/e20230129-lantern-vqhoj8/index.html?game_biz=hk4e_cn&mhy_presentation_style=fullscreen&mhy_landscape=true&mhy_hide_status_bar=true&mhy_auth_required=true&utm_source=bbs&utm_medium=mys&utm_campaign=banner"
      },
      ...
    ],
    "recommended_posts": [
      {
        "post": {
          "game_id": 2,
          "post_id": "35089752",
          "f_forum_id": 43,
          "uid": "159922380",
          "subject": "蔷薇再开时第二天！全试用角色轻松拿满奖励攻略",
          "content": "UID ：100335197[图片]★活动时间：2023/01/31 10:00 ~ 2023/02/13 03:59(五天全解锁，也可以选择等五天后一起完成全部挑战小活动[图片]★参与条件：",
          "cover": "https://upload-bbs.miyoushe.com/upload/2023/02/01/159922380/e55509db76dab0d99ed28fcee9204bc0_8172512981975837842.jpg",
          "view_type": 1,
          "created_at": 1675213042,
          "images": [
            "https://upload-bbs.miyoushe.com/upload/2023/02/01/159922380/e55509db76dab0d99ed28fcee9204bc0_8172512981975837842.jpg",
            ...
          ],
          "post_status": {
            "is_top": false,
            "is_good": false,
            "is_official": false
          },
          "topic_ids": [
            236,
            357,
            405,
            425,
            947,
            1300
          ],
          "view_status": 1,
          "max_floor": 860,
          "is_original": 1,
          "republish_authorization": 2,
          "reply_time": "2023-02-05 09:40:12",
          "is_deleted": 0,
          "is_interactive": false,
          "score": 0
        },
        "forum": {
          "id": 43,
          "name": "攻略"
        },
        "topics": [
          {
            "id": 236,
            "name": "其他攻略",
            "cover": "https://upload-bbs.mihoyo.com/upload/2020/09/14/98dcbb80d92d523566755072a55a6ed1.png",
            "content_type": 3
          },
          {
            "id": 357,
            "name": "讨伐手册",
            "cover": "https://upload-bbs.mihoyo.com/upload/2020/09/14/acb13eaaad8e5c32a5fd3b3d02551614.png",
            "content_type": 2
          },
          {
            "id": 405,
            "name": "任务攻略",
            "cover": "https://upload-bbs.miyoushe.com/upload/2023/01/16/c5941f10bb2792ff40d88107f22ee935_2565180896808939451.png",
            "content_type": 2
          },
          {
            "id": 425,
            "name": "丽莎",
            "cover": "https://upload-bbs.mihoyo.com/upload/2020/11/25/87d31799fc896fe1128e2b4d7cafcafd.jpeg",
            "content_type": 1
          },
          {
            "id": 947,
            "name": "原神观测枢",
            "cover": "https://upload-bbs.mihoyo.com/upload/2022/02/14/8efc5670a3dd0467bf7fb1866bd5d203_2630690909080422615.png",
            "content_type": 2
          },
          {
            "id": 1300,
            "name": "蔷薇再开时",
            "cover": "https://upload-bbs.miyoushe.com/upload/2023/01/17/8dc22847a6730958d8acef2d49b23779_3259150493896385055.jpg",
            "content_type": 2
          }
        ],
        "user": {
          "uid": "159922380",
          "nickname": "李沐瑟",
          "introduce": "那啥，我能玩到游戏倒闭，萌新交流群798414372 ",
          "avatar": "100302",
          "gender": 0,
          "certification": {
            "type": 2,
            "label": "游戏领域作者、观测者、攻略作者"
          },
          "level_exp": {
            "level": 16,
            "exp": 80360
          },
          "avatar_url": "https://img-static.mihoyo.com/communityweb/upload/e92b5e783ae5ba9d372b4b14f8139a6a.png",
          "pendant": "https://upload-bbs.mihoyo.com/upload/2022/02/15/91e40b079e86bc6f93339be4f68038d1_4869129021901406468.png",
          "is_following": false,
          "is_followed": false
        },
        "self_operation": null,
        "stat": {
          "reply_num": 0,
          "view_num": 0,
          "like_num": 0,
          "bookmark_num": 0
        },
        "cover": {
          "url": "https://upload-bbs.miyoushe.com/upload/2023/02/01/159922380/e55509db76dab0d99ed28fcee9204bc0_8172512981975837842.jpg",
          "height": 600,
          "width": 1067,
          "format": "jpg",
          "size": "837613",
          "crop": null,
          "is_user_set_cover": true,
          "image_id": "122589789",
          "entity_type": "IMG_ENTITY_POST",
          "entity_id": "35089752"
        },
        "image_list": [
          {
            "url": "https://upload-bbs.miyoushe.com/upload/2023/02/01/159922380/e55509db76dab0d99ed28fcee9204bc0_8172512981975837842.jpg",
            "height": 600,
            "width": 1067,
            "format": "jpg",
            "size": "837613",
            "crop": null,
            "is_user_set_cover": false,
            "image_id": "122589789",
            "entity_type": "IMG_ENTITY_POST",
            "entity_id": "35089752"
          },
          ...
        ],
        "is_official_master": false,
        "is_user_master": false,
        "help_sys": {
          "top_up": null
        },
        "vote_count": 0,
        "last_modify_time": 0,
        "recommend_type": "",
        "collection": null,
        "vod_list": [
          {
            "id": "1620586068908748800",
            "duration": 242742,
            "cover": "https://upload-bbs.miyoushe.com/upload/2023/02/01/159922380/68a6611248ef8e1515ee63aa5483d2d2_3826365170291205335.jpg",
            "resolutions": [
              {
                "url": "https://vod-static.miyoushe.com/1/2023-02-01/43828081vodtranscq1500002267/f6f470f9243791579138374920/v.f270753.mp4",
                "definition": "480P",
                "height": 480,
                "width": 852,
                "bitrate": 597038,
                "size": "18114283",
                "format": ".mp4",
                "label": "480P"
              },
              {
                "url": "https://vod-static.miyoushe.com/1/2023-02-01/43828081vodtranscq1500002267/f6f470f9243791579138374920/v.f270754.mp4",
                "definition": "720P",
                "height": 720,
                "width": 1280,
                "bitrate": 2235841,
                "size": "67836002",
                "format": ".mp4",
                "label": "720P"
              },
              {
                "url": "https://vod-static.miyoushe.com/1/2023-02-01/43828081vodtranscq1500002267/f6f470f9243791579138374920/v.f270755.mp4",
                "definition": "1080P",
                "height": 1080,
                "width": 1920,
                "bitrate": 2796292,
                "size": "84840207",
                "format": ".mp4",
                "label": "1080P"
              }
            ],
            "view_num": 2035,
            "transcoding_status": 2,
            "review_status": 2
          }
        ]
      },
      ...
    ],
    "recommended_topics": {
      "list": [
        {
          "id": 1271,
          "name": "艾尔海森",
          "cover": "https://upload-bbs.miyoushe.com/upload/2022/12/15/889ce8e53fe5f84690ce304dc8c5dcbb_3093437298134130485.jpg",
          "desc": "",
          "is_focus": false,
          "view_num": 0,
          "discuss_num": 0
        },
        ...
      ],
      "position": 2
    },
    "fixed_posts": [],
    "selection_post_list": [
      {
        "post_id": "34160507",
        "subject": "原神周本收益分析，老周本BOSS还有打的必要吗",
        "forum_id": 43,
        "forum_name": "攻略",
        "banner": "https://upload-bbs.miyoushe.com/upload/2023/01/10/218792574/4f45a97be9a58d3c601fc88b41422e70_8341995634206658477.png",
        "view_type": 1
      },
      ...
    ]
  }
}

获取官方资讯

请求方式：GET

https://bbs-api.miyoushe.com/post/wapi/getNewsList

参数：

字段 类型 内容 备注
gids num 游戏ID
type num 资讯类型
1 公告
2 活动
3 资讯
page_size num 每页文章数量
1~50		 若未指定或超出范围则为每页20篇

JSON返回：

根对象：

字段 类型 内容 备注
retcode num 返回码
1001 参数type不正确
1002 参数gids不正确
message str 返回消息
data obj 资讯信息

data对象

字段 类型 内容 备注
list arr 资讯信息
last_id num 待调查
is_last bool 待调查

data对象→list数组→对象：

字段 类型 内容 备注
查看示例 
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "list": [
      {
        "post": {
          "game_id": 2,
          "post_id": "39530410",
          "f_forum_id": 28,
          "uid": "384454482",
          "subject": "「原神赛事解说主持招募」计划启动",
          "content": "▌「原神赛事解说主持招募」计划启动亲爱的旅行者，请查收这份招募指南！即日起至5月28日，原神赛事将开启首批解说主持招募报名如果你正在寻找演艺的契机，不如一起开启一段崭新的冒险吧！★ 期待",
          "cover": "",
          "view_type": 1,
          "created_at": 1684555284,
          "images": [
            "https://upload-bbs.miyoushe.com/upload/2023/05/20/384454482/316ebd6113fd3923768a73e4d097a296_7231734090118733998.jpg"
          ],
          "post_status": {
            "is_top": false,
            "is_good": false,
            "is_official": true
          },
          "topic_ids": [
            1264
          ],
          "view_status": 1,
          "max_floor": 38,
          "is_original": 0,
          "republish_authorization": 0,
          "reply_time": "2023-05-20 15:40:55",
          "is_deleted": 0,
          "is_interactive": false,
          "structured_content": "[{\"insert\":\"▌「原神赛事解说主持招募」计划启动\\n\\n亲爱的旅行者，请查收这份招募指南！\\n\\n即日起至5月28日，原神赛事将开启首批解说主持招募报名\\n如果你正在寻找演艺的契机，不如一起开启一段崭新的冒险吧！\\n\\n★ 期待看见在舞台上闪耀的大家！\\n\"},{\"insert\":{\"image\":\"136156250\"}},{\"insert\":\"\\n\\n\"}]",
          "structured_content_rows": [],
          "review_id": 0,
          "is_profit": false,
          "is_in_profit": false,
          "updated_at": 1684568455,
          "deleted_at": 0,
          "pre_pub_status": 0,
          "cate_id": 0,
          "profit_post_status": -2,
          "audit_status": 0,
          "meta_content": "",
          "is_missing": false,
          "block_reply_img": 1,
          "is_showing_missing": false,
          "block_latest_reply_time": 0,
          "selected_comment": 0
        },
        "forum": {
          "id": 28,
          "name": "官方",
          "icon": "https://upload-bbs.mihoyo.com/upload/2020/04/05/1e49d332b6ca6dc3367801eea655dfdb.png",
          "game_id": 2,
          "forum_cate": null
        },
        "topics": [
          {
            "id": 1264,
            "name": "七圣召唤",
            "cover": "https://upload-bbs.miyoushe.com/upload/2022/11/25/fbab7b47dce9d09cb1f06557531ac9a1_1617410903526086645.jpg",
            "is_top": false,
            "is_good": false,
            "is_interactive": false,
            "game_id": 0,
            "content_type": 2
          }
        ],
        "user": {
          "uid": "384454482",
          "nickname": "原神赛事",
          "introduce": "",
          "avatar": "101070",
          "gender": 0,
          "certification": {
            "type": 1,
            "label": "原神赛事官方账号"
          },
          "level_exp": {
            "level": 3,
            "exp": 172
          },
          "is_following": false,
          "is_followed": false,
          "avatar_url": "https://bbs-static.miyoushe.com/static/2023/05/12/b85ea3822de881e64920ffdf3d8aed77_1765242819614536153.png",
          "pendant": ""
        },
        "self_operation": {
          "attitude": 0,
          "is_collected": false
        },
        "stat": {
          "view_num": 2524,
          "reply_num": 54,
          "like_num": 439,
          "bookmark_num": 7,
          "forward_num": 5
        },
        "help_sys": {
          "top_up": null,
          "top_n": [],
          "answer_num": 0
        },
        "cover": null,
        "image_list": [
          {
            "url": "https://upload-bbs.miyoushe.com/upload/2023/05/20/384454482/316ebd6113fd3923768a73e4d097a296_7231734090118733998.jpg",
            "height": 2817,
            "width": 1000,
            "format": "jpg",
            "size": "1294054",
            "crop": null,
            "is_user_set_cover": false,
            "image_id": "136156250",
            "entity_type": "IMG_ENTITY_POST",
            "entity_id": "39530410",
            "is_deleted": false
          }
        ],
        "is_official_master": false,
        "is_user_master": false,
        "hot_reply_exist": false,
        "vote_count": 0,
        "last_modify_time": 0,
        "recommend_type": "",
        "collection": null,
        "vod_list": [],
        "is_block_on": false,
        "forum_rank_info": null,
        "link_card_list": [],
        "news_meta": {
          "activity_status": 0,
          "start_at_sec": "0",
          "end_at_sec": "0"
        }
      }
    ],
    "last_id": 1,
    "is_last": false
  }
}

获取完整文章信息

请求方式：GET

需要验证请求头

网页：https://bbs-api.miyoushe.com/post/wapi/getPostFull 应用：https://bbs-api.miyoushe.com/post/api/getPostFull

参数：

字段 类型 内容 备注
post_id num 文章ID

JSON返回：

根对象：

字段 类型 内容 备注
retcode num 返回码
1101 参数post_id对应的文章不存在
message str 返回消息
data obj 首页信息
查看示例