末忆铁锈盒子 API 接口文档

数据源:末忆铁锈盒子(rtsbox.cn)公开 BBS 搜索接口。本页依据公开文档与启动器实际对接整理。

基本信息

接口地址 https://www.rtsbox.cn/api/search_bbs.php
请求方式 POST
功能描述 用于根据 BBS ID、关键词搜索及分页条件查询 BBS 资源

请求参数

请求格式:form-data

参数名 类型 描述
bbs_id string 要查询的 BBS(论坛)资源 ID。其中 4 是模组,5 为地图
keyword string 搜索关键词
page string 分页查询页码

响应格式

响应数据类型:JSON

字段名 类型 描述
code integer HTTP 状态码,例如 200 表示请求成功
message string 响应状态的消息,例如 "success"
data array 返回的资源列表,每项包含资源详情

data 字段详情

字段名 类型 描述
title string 资源标题或描述
downurl string 资源的直接下载链接
img string 资源预览图地址
bbsurl string 资源在 BBS 上的链接地址

示例响应

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "title": "金属与血肉模组0.1测试版",
            "downurl": "http://cdn.rtsbox.cn/my_down.php/vJlDKtL3",
            "img": "https://css.rtsbox.cn/user_files/44289/publish/post/23685412_1749960240.jpeg",
            "bbsurl": "https://www.rtsbox.cn/16683.html"
        },
        {
            "title": "穷途末路6.3",
            "downurl": "http://cdn.rtsbox.cn/my_down.php/ctXFfoh2",
            "img": "https://css.rtsbox.cn/user_files/133/publish/post/94987053_1749466890.jpeg",
            "bbsurl": "https://www.rtsbox.cn/16538.html"
        }
    ]
}

调用示例

curl

curl.exe -X POST "https://www.rtsbox.cn/api/search_bbs.php" \
  -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" \
  -H "Referer: https://www.rtsbox.cn/" \
  -H "X-Requested-With: XMLHttpRequest" \
  -d "bbs_id=4&keyword=%25&page=1"

Python

import requests

resp = requests.post(
    "https://www.rtsbox.cn/api/search_bbs.php",
    data={"bbs_id": "4", "keyword": "%", "page": "1"},
    headers={
        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/124.0",
        "Referer": "https://www.rtsbox.cn/",
        "X-Requested-With": "XMLHttpRequest",
    },
    timeout=15,
)
data = resp.json().get("data", [])
for item in data:
    print(item["title"], item["downurl"])

注意:keyword 为空时,接口不会返回 JSON,而是返回"暂没有数据"的 HTML 页面。建议在空查询时改用通配关键词 %,并做好非 JSON 响应的兜底处理。

状态码说明

状态码 描述
200 请求成功,返回资源信息
400 请求参数错误
404 未找到资源
500 服务器内部错误

本页由 CQRWL 依据末忆铁锈盒子公开文档整理,接口版权归末忆铁锈盒子所有。