# 资源类API

[GET] /resources/{id} 查询资源信息
[GET] /resources/{id}/updates 查询资源更新日志
[POST] /resources/{id}/update 发布资源更新

# [GET] /resources/{id} 查询资源信息

说明

使用ID查询资源的信息

ep:https://api.minebbs.com/api/openapi/v1/resources/13 (opens new window)

# 可用参数

此API没有可用参数

# 响应

{
    "success": true,
    "status": 2000,
    "message": "OK，DaZe",
    "version": "v1",
    "codename": "Accelerator",
    "time": 1643540879,
    "data": {
        "title": "Minecraft 基岩版/国际版 正式版 安卓版 安装包", //资源标题
        "version": "1.18.2.03", //资源最新版本
        "last_update": 1639110321, //最后更新时间
        "update_count": 53, //更新次数
        "view_count": 84338, //查看次数
        "download_count": 4267, //下载次数
        "review_count": 101, //评论数量
        "tag_line": "MCPE是一款沙盒式建造游戏，玩家可以在游戏中的三维空间里创造和破坏零零总总的方块", //资源描述
        "icon_url": "https://www.minebbs.com/data/resource_icons/0/13.jpg?1532605567", //资源图标
        "description_parsed": "<b>Minecraft 基岩版 是指包括Minecraft 手机版（Android、IOS）、Win10版（VR）、主机版（XboxOne、NS）在内的 使用“基岩引擎”（C++语言）开发的Minecraft 统一版本。<br />\n正式版是 Minecraft 基岩版 经过一段时间的测试版测试之后得到的稳定版本，也是众多材质、Addons和官方领域服会逐渐跟进的版本。与此同时Google Play、Win10 Store等官方软件商城也会推送更新。</b><br />\n<br />\n我们会基本保持同步、持续更新<br />\n<br />\n<b><span style=\"color: rgb(65, 168, 95)\"><b><span style=\"font-size: 18px\">本资源仅供用户体验游戏特性和学习使用，请于24H内删除！</span><br />\n<span style=\"font-size: 18px\">条件允许的话请前往官网、Windows Store或者GooglePlay支持正版！</span></b></span><br />\n<br />\n请选择这四项下载！！！<br />\n<span style=\"color: rgb(65, 168, 95)\"><b><span style=\"font-size: 18px\"><img src=\"https://www.minebbs.com/attachments/20283/\" alt=\"1634309489233.png\" /></span></b></span></b><br />\n<span style=\"font-size: 15px\"><b>这个是图片广告，不要被骗，小心下载器：</b></span><br />\n<img src=\"https://www.minebbs.com/attachments/20284/\" alt=\"1634309527688.png\" /><br />\n<br />\n<b><span style=\"color: rgb(209, 72, 65)\"><span style=\"font-size: 18px\">本帖只从1.2.10开始搬运最新的MCPE正式版，历史版本请见：<a href=\"https://www.minebbs.com/resources/minecraftpe.110/\" class=\"link link--internal\">https://www.minebbs.com/resources/minecraftpe.110/</a><br />\n<br />\n测试版请见：<br />\n<a href=\"https://www.minebbs.com/resources/minecraftpe-beta.81/\" class=\"link link--internal\">https://www.minebbs.com/resources/minecraftpe-beta.81/</a> </span></span><br />\n<br />\nAndroid用户：</b><br />\n<ul>\n<li data-xf-list-type=\"ul\">系统版本至少为<u>Android4.2</u>或更高（Android7.0可用/8.0用户反映可用）</li>\n<li data-xf-list-type=\"ul\">机型：能正常使用均可</li>\n</ul><b>IOS用户：</b><br />\n<ul>\n<li data-xf-list-type=\"ul\">需要<u>IOS 8.0</u>或更高版本</li>\n<li data-xf-list-type=\"ul\">机型：iPhone 5/5c/5s、iPhone 6/6s、iPhone 7、iPhone X、iPhone 8、iPhone SE</li>\n</ul><b>其他用户：</b><br />\n<ul>\n<li data-xf-list-type=\"ul\">自行测试</li>\n</ul>转载本贴时须要注明<b>原作者</b>以及<b>本帖地址</b>。", //资源信息(H5)
        "price": "0.00", //资源价格
        "rating_avg": 0, //资源平均评分
        "rating_count": 92, //资源评分数量
        "resource_date": 1519391277, //资源上传日期
        "resource_state": "visible", //资源状态
        "resource_type": "download", //资源类型
        "view_url": "https://www.minebbs.com/minecraft/" //查看链接
    }
}

# Status

Status	Message	解释
2000	OK，DaZe	查询成功
4000	请提交正确的资源ID	参数不正确
4040	查询的资源不存在哦	查询的资源不存在
5000	请求失败，服务器出现异常了哦	服务器出错

# [GET] /resources/{id}/updates 查询资源更新日志

说明

使用ID查询资源的更新日志

分页API

此API需要分页查询，一页返回10条

ep:https://api.minebbs.com/api/openapi/v1/resources/13/updates?page=1 (opens new window)

# 可用参数

[GET]

参数	类型	解释
page	int	分页页数，不提交默认为1

# 响应

{
    "success": true,
    "status": 2000,
    "message": "OK，DaZe",
    "version": "v1",
    "codename": "Accelerator",
    "time": 1643541515,
    "data": [
        {
            "title": "1.18.2.03", //更新标题
            "message": "修复各种错误", //更新信息
            "post_date": 1639110321, //更新提交日期
            "resource_update_id": 10155, //更新ID
            "view_url": "https://www.minebbs.com/minecraft/update/10155/" //查看链接
        },
        {
            "title": "1.18.1.02",
            "message": "修复若干问题",
            "post_date": 1638757427,
            "resource_update_id": 10140,
            "view_url": "https://www.minebbs.com/minecraft/update/10140/"
        }
    ]
}

# Status

Status	Message	解释
2000	OK，DaZe	查询成功
4000	请提交正确的资源ID	参数不正确
4001	请提交正确的页码	页码提交不正确
4002	分页数量超过上限啦	分页数量超过上限
4040	查询的资源不存在哦	查询的资源不存在
5000	请求失败，服务器出现异常了哦	服务器出错

# [POST] /resources/{id}/update 发布资源更新

说明

为现有资源发布一个新版本

APIToken

此API需要提交有效的APIToken

较为严格的速率限制

此API在12小时内只能请求10次，超过限制会抛出错误

上传文件

文件需要使用上传文件API上传，上传完成后将获得的FileKey填写进参数即可

ep:https://api.minebbs.com/api/openapi/v1/resources/1/update (opens new window)

# 可用参数

[Raw][Json]

最少提交一个参数

file_key与file_url必须选择一个提交

{
    "title": "", // 更新标题
    "description": "", // 更新内容描述
    "new_version": "", // 新版本号
    "file_key": "", // 文件Key，只能上传一个文件(可选)
    "file_url": "" // 文件URL(可选)
}

# 响应

{
    "success": true,
    "status": 2000,
    "message": "OK，DaZe",
    "version": "v1",
    "codename": "Accelerator",
    "time": 1647090116,
    "data": []
}

# Status

Status	Message	解释
2000	OK，DaZe	查询成功
4000	请提交正确的资源ID/无法解析Json/请提交正确的文件key	参数不正确
4030	没有操作这个资源的权限	没有操作指定资源的权限
5000	请求失败，服务器出现异常了哦	服务器出错

← 用户类API 通知类API →