1. shops
nearcade
  • 默认
    • clubs
      • 获取社团列表 / Get clubs
      • 获取社团详情 / Get club details
      • 获取社团收藏店铺 / Get club arcades
      • 上传社团头像 / Upload club avatar
      • 获取社团成员 / Get club members
      • 获取社团帖子 / Get club posts
      • 创建社团帖子 / Create club post
    • comments
      • 更新评论。 / Update a comment.
      • 删除评论。 / Delete a comment.
      • 对评论投票。 / Vote on a comment.
    • discover
      • 获取附近店铺 / Discover nearby shops
    • images
      • 上传图片资源。 / Upload an image asset.
      • 删除图片资源。 / Delete an image asset.
    • posts
      • 获取公告列表。 / List announcements.
      • 创建公告。 / Create announcement.
      • 更新公告已读状态。 / Update announcement read state.
      • 获取帖子详情。 / Get post details.
      • 更新帖子。 / Update post.
      • 删除帖子。 / Delete post.
      • 发表评论到帖子。 / Post a comment.
      • 更新公告。 / Update announcement.
      • 为帖子投票。 / Vote on a post.
      • 删除公告。 / Delete announcement.
    • shops
      • 获取店铺列表。 / List shops.
        GET
      • 创建店铺。 / Create shop.
        POST
      • 获取店铺详情。 / Get shop details.
        GET
      • 更新店铺。 / Update shop.
        PUT
      • 管理员更新店铺。 / Admin update shop.
        PATCH
      • 获取在勤人数。 / Get attendance.
        GET
      • 登记在勤或上报在勤人数（已弃用）。 / Register or report attendance (deprecated).
        POST
      • 退勤。 / Leave attendance.
        DELETE
      • 登记在勤。 / Register attendance.
        POST
      • 上报在勤人数。 / Report attendance counts.
        POST
      • 申请玩家登记令牌。 / Create player registration token.
        POST
      • 获取玩家登记信息。 / Get player registration.
        GET
      • 销毁玩家登记令牌。 / Delete player registration token.
        DELETE
      • 获取店铺更新记录。 / Get shop changelog.
        GET
      • 删除店铺更新记录。 / Delete a shop changelog entry.
        DELETE
      • 获取店铺评论。 / Get shop comments.
        GET
      • 发表评论到店铺。 / Post a shop comment.
        POST
      • 提交店铺删除申请。 / Submit a shop delete request.
        POST
      • 获取在勤历史。 / Get attendance history.
        GET
      • 获取店铺照片。 / Get shop photos.
        GET
      • 上传店铺照片。 / Upload a shop photo.
        POST
      • 删除店铺照片。 / Delete a shop photo.
        DELETE
      • 获取机台队列。 / Get machine queues.
        GET
      • 上报机台队列。 / Report machine queues.
        POST
      • 获取删除申请列表。 / List delete requests.
        GET
      • 获取删除申请详情。 / Get delete request details.
        GET
      • 审核删除申请。 / Review a delete request.
        PATCH
      • 删除或撤回删除申请。 / Delete or retract a delete request.
        DELETE
      • 获取删除申请评论。 / Get delete request comments.
        GET
      • 发表评论到删除申请。 / Post a comment on a delete request.
        POST
      • 对删除申请投票。 / Vote on a delete request.
        POST
    • universities
      • 搜索大学 / Search universities
      • 获取大学详情 / Get university details
      • 上传大学头像 / Upload university avatar
      • 获取大学变更记录 / Get university changelog
      • 获取大学社团 / Get university clubs
      • 获取大学成员 / Get university members
      • 获取大学帖子 / Get university posts
      • 创建大学帖子 / Create university post
    • users
      • 获取用户资料。 / Get a user profile.
      • 获取用户活动。 / Get user activities.
      • 获取用户活动热力图。 / Get user activity heatmap.
      • 上传用户头像。 / Upload a user avatar.
      • 获取当前用户资料。 / Get the current user profile.
    • ugc
      • 查询 AI 自动翻译偏好 / Get AI auto-translation preferences
      • 更新 AI 自动翻译偏好 / Update AI auto-translation preferences
      • 批量查询 UGC 译文缓存 / Batch-look up cached UGC translations
    • rankings
      • 获取地铁站排名 / Get metro station rankings
      • 获取校区排名 / Get campus rankings
      • 获取地区排名 / Get region rankings
    • game-titles
      • 获取游戏系列列表。 / List the game titles.
    • globe
      • 获取地球视图数据。 / Get the globe data.
      • 获取地球视图标记。 / Get the globe markers.
      • 获取地球视图店铺。 / Get the globe shops.
    • home
      • 获取最近的店铺更新记录。 / Get the recent shop changelog.
      • 获取首页统计。 / Get the home page statistics.
    • notifications
      • 获取通知列表。 / List notifications.
      • 标记通知为已读。 / Mark notifications as read.
      • 管理 FCM 设备令牌。 / Manage the FCM device token.
    • phone
      • 解绑手机号。 / Unbind the phone number.
      • 发送手机验证码。 / Send a phone verification code.
      • 查询手机号验证状态。 / Get the phone verification status.
      • 验证手机号。 / Verify a phone number.
    • regions
      • 获取地区选项。 / List region selector options.
      • 获取地区层级。 / Get a region hierarchy.
  • 过时
    • 获取附近店铺
    • 获取店铺列表
    • 激活机台
    • 获取店铺详情
    • 申请玩家登记令牌
    • 获取玩家登记信息
    • 获取在勤人数
    • 销毁玩家登记令牌
    • 上报在勤人数
    • 上报机台队列
    • 数据模型
      • Shop
      • User
      • Game
  1. shops

管理员更新店铺。 / Admin update shop.

PATCH
/shops/{id}
管理员按 ID 更新店铺的管理字段（如锁定状态）。
Admin-only endpoint to update administrative shop fields (e.g. locked status) by ID.

请求参数

Path 参数

Body 参数application/json

示例
{
    "isLocked": true
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://nearcade.cn/api/shops/' \
--header 'Content-Type: application/json' \
--data '{
    "isLocked": true
}'

返回响应

🟢200成功
application/json
OK
Bodyapplication/json

示例
{
    "shop": {
        "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": ""
            }
        ],
        "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"
    }
}
🟠400请求有误
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
🟠409
🟠410记录不存在
🟠429
🔴500服务器错误
🔴502网关错误
修改于 2026-10-23 22:59:16
上一页
更新店铺。 / Update shop.
下一页
获取在勤人数。 / Get attendance.
Built with