- 默认
- clubs
- comments
- discover
- images
- posts
- shops
- 获取店铺列表。 / List shops.
- 创建店铺。 / Create shop.
- 获取店铺详情。 / Get shop details.
- 更新店铺。 / Update shop.
- 管理员更新店铺。 / Admin update shop.
- 获取 在勤人数。 / Get attendance.
- 登记在勤或上报在勤人数（已弃用）。 / Register or report attendance (deprecated).
- 退勤。 / Leave attendance.
- 登记在勤。 / Register attendance.
- 上报在勤人数。 / Report attendance counts.
- 申请玩家登记令牌。 / Create player registration token.
- 获取玩家登记信息。 / Get player registration.
- 销毁玩家登记令牌。 / Delete player registration token.
- 获取店铺更新记录。 / Get shop changelog.
- 删除店铺更新记录。 / Delete a shop changelog entry.
- 获取店铺评论。 / Get shop comments.
- 发表评论到店铺。 / Post a shop comment.
- 提交店铺删除申请。 / Submit a shop delete request.
- 获取在勤历史。 / Get attendance history.
- 获取店铺照片。 / Get shop photos.
- 上传店铺照片。 / Upload a shop photo.
- 删除店铺照片。 / Delete a shop photo.
- 获取机台队列。 / Get machine queues.
- 上报机台队列。 / Report machine queues.
- 获取删除申请列表。 / List delete requests.
- 获取删除申请详情。 / Get delete request details.
- 审核删除申请。 / Review a delete request.
- 删除或撤回删除申请。 / Delete or retract a delete request.
- 获取删除申请评论。 / Get delete request comments.
- 发表评论到删除申请。 / Post a comment on a delete request.
- 对删除申请投票。 / Vote on a delete request.
- universities
- users
- ugc
- rankings
- game-titles
- globe
- home
- notifications
- phone
- regions
- 过时
获取附近店铺 / Discover nearby shops
GET
/discover
radius 同时表示出行时间预算：每个距离档位都对应一个通常所需的出行时间，服务端据此为每家店铺计算最快的到达方式（步行 / 骑行 / 地铁），因此地铁可达的店铺可能超出半径范围——结果始终按出行时间排序，并按 limit 截断。当地铁数据可用时（原点 3 km 内有运营车站），响应还会附带 metro 行程块：包含最快方式为地铁的店铺的完整行程（乘车站序、官方线路色与短号），浏览器可直接渲染，无需额外请求。注意：limit=150 且命中较多地铁行程时响应可达约 270 KB（gzip 后约 90 KB）。radius doubles as the travel-time budget: each distance option implies the time it typically takes, and the server computes each shop’s fastest option (walk / ride / metro) accordingly — so metro-reachable shops may sit beyond the radius. Results are always ranked by travel time and cut to limit. When metro data is available (origin within 3 km of an operating station), the response also carries a metro itinerary block covering the shops whose fastest option is the metro (station sequences, official line colors and short codes) — ready to render with zero follow-up requests. Note: with limit=150 and many metro itineraries the response can reach ~270 KB (~90 KB gzipped).请求参数
Query 参数
请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://nearcade.cn/api/discover?longitude=undefined&latitude=undefined&radius=undefined&limit=undefined&f=undefined&gameTitleIds=undefined&name=undefined&fetchAttendance=undefined&includeTimeInfo=undefined&convertFrom=undefined&lat=undefined&lng=undefined'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"shops": [
{
"id": -9007199254740991,
"name": "string",
"comment": "string",
"address": {
"general": [
"string"
],
"detailed": "string",
"region": [
{
"id": "string",
"name": "string"
}
]
},
"openingHours": [
[
{
"hour": 0,
"minute": 0
},
{
"hour": 0,
"minute": 0
}
]
],
"games": [
{
"gameId": -9007199254740991,
"titleId": -9007199254740991,
"name": "string",
"version": "string",
"comment": "",
"quantity": 1,
"cost": "",
"totalAttendance": 0
}
],
"location": {
"type": "Point",
"coordinates": []
},
"timezone": {
"name": "string",
"offset": 0
},
"isOpen": true,
"isClaimed": true,
"ownerId": "string",
"isLocked": true,
"isClosed": true,
"closedReason": "string",
"transit": {
"metro": {
"networkId": "string",
"stationId": "string",
"stationName": "string",
"names": {
"zh": "string",
"en": "string"
},
"walkSeconds": 0,
"distanceKm": 0,
"lines": [
{
"id": "string",
"name": "string",
"names": {
"zh": "string",
"en": "string"
},
"color": "string",
"shortName": "string"
}
]
}
},
"createdAt": "2019-08-24T14:15:22.123Z",
"updatedAt": "2019-08-24T14:15:22.123Z",
"distance": 0,
"travel": {
"seconds": 0,
"metroSeconds": 0
},
"totalAttendance": 0,
"currentReportedAttendance": {
"reportedAt": "2019-08-24T14:15:22.123Z",
"reportedBy": "string",
"reporter": {
"id": "string",
"name": "string",
"image": "string",
"displayName": "string"
},
"comment": "string"
}
}
],
"location": {
"name": "string",
"latitude": 0,
"longitude": 0
},
"radius": 0,
"limit": 0,
"gameTitleIds": [
0
],
"metro": {
"network": {
"id": "string",
"name": "string",
"names": {
"zh": "string",
"en": "string"
},
"cityRegionId": "string"
},
"origin": {
"stationId": "string",
"stationName": "string",
"names": {
"zh": "string",
"en": "string"
},
"walkSeconds": 0,
"lon": 0,
"lat": 0
},
"lines": {
"property1": {
"id": "string",
"name": "string",
"names": {
"zh": "string",
"en": "string"
},
"color": "string",
"shortName": "string"
},
"property2": {
"id": "string",
"name": "string",
"names": {
"zh": "string",
"en": "string"
},
"color": "string",
"shortName": "string"
}
},
"stations": {
"property1": {
"name": "string",
"names": {
"zh": "string",
"en": "string"
},
"lon": 0,
"lat": 0
},
"property2": {
"name": "string",
"names": {
"zh": "string",
"en": "string"
},
"lon": 0,
"lat": 0
}
},
"shops": {
"property1": {
"totalSeconds": 0,
"rideSeconds": 0,
"transferCount": 0,
"legs": [
{
"kind": "ride",
"lineId": "string",
"stationIds": [
"string"
],
"seconds": 0,
"distanceKm": 0,
"direction": "string"
}
]
},
"property2": {
"totalSeconds": 0,
"rideSeconds": 0,
"transferCount": 0,
"legs": [
{
"kind": "ride",
"lineId": "string",
"stationIds": [
"string"
],
"seconds": 0,
"distanceKm": 0,
"direction": "string"
}
]
}
}
}
}🟠400请求有误
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
🟠409
🟠410记录不存在
🟠429
🔴500服务器错误
🔴502网关错误
修改于 2026-10-23 22:59:16