小黑盒即将上线游戏
接口说明
小黑盒「即将上线/最近上线」游戏列表，默认显示今天即将上线的游戏
请求示例
请求地址
https://api.tangdouz.com/a/hbox/recent.php
请求地址
https://api.tangdouz.com/a/hbox/recent.php?return=text
请求地址
https://api.tangdouz.com/a/hbox/recent.php?return=json
请求地址
https://api.tangdouz.com/a/hbox/recent.php?date=2026.11.02
请求地址
https://api.tangdouz.com/a/hbox/recent.php?flat=1&limit=5
请求地址
https://api.tangdouz.com/a/hbox/recent.php?platform=switch
请求地址
https://api.tangdouz.com/a/hbox/recent.php?next=0
请求参数说明
date=可选，指定日期，格式YYYY.MM.DD，默认今天；platform=可选，平台筛选(steam/pc/xbox/switch/ps4)；flat=可选，填1返回扁平列表；limit=可选，扁平模式限制条数；next=可选，默认开启(该日期没有游戏时自动顺延到最近有游戏的一天)，填0可关闭；return=空或text输出纯文本，json输出JSON
| 参数名 | 说明 | 是否必填 |
|---|---|---|
return |
text | 是 |
date |
2026.11.02 | 是 |
flat |
1 | 是 |
limit |
5 | 是 |
platform |
switch | 是 |
next |
0 | 是 |
返回参数说明
| 参数名 | 说明 |
|---|---|
code |
状态码：200成功 |
date |
查询日期 |
total |
当天游戏总数 |
fetchedAt |
数据更新时间 |
groups |
按日期分组的结果 |
next |
该日期没有游戏、且未发生顺延(next=0)时返回，为「最近有游戏的那天」({date,count}) |
requested |
发生自动顺延时返回，为原始请求日期(next=0 时不顺延、不返回) |
name |
游戏名称 |
steam_appid |
Steam AppID |
platforms |
平台列表(steam/pc/xbox/switch/ps4) |
price |
价格(current现价/initial原价/discount折扣%) |
is_free |
是否免费 |
follow_num |
关注数 |
expect_num |
期待数 |
image |
游戏封面图 |
JSON返回示例
JSON格式
{
"code": 200,
"date": "2026.09.08",
"total": 5,
"fetchedAt": "2026-09-08T07:16:25+00:00",
"groups": [
{
"date": "2026.09.08",
"day_timestamp": 1788796800,
"count": 5,
"games": [
{
"name": "骰途酒馆",
"steam_appid": 4587610,
"platforms": [
"steam"
],
"price": {
"current": "34.4",
"initial": "43",
"discount": 20
},
"is_free": false,
"follow_num": 5728,
"expect_num": 7,
"image": "https:\/\/heyboxbj.max-c.com\/gameimg\/steam_item_assets\/4587610\/391b6829e22366719c3c9f7374d78262.jpg?imageMogr2\/thumbnail\/460x215%3E\/format\/webp"
}
]
}
]
}