1. posts
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.
        GET
      • 创建公告。 / Create announcement.
        POST
      • 更新公告已读状态。 / Update announcement read state.
        POST
      • 获取帖子详情。 / Get post details.
        GET
      • 更新帖子。 / Update post.
        PUT
      • 删除帖子。 / Delete post.
        DELETE
      • 发表评论到帖子。 / Post a comment.
        POST
      • 更新公告。 / Update announcement.
        PUT
      • 为帖子投票。 / Vote on a post.
        POST
      • 删除公告。 / Delete announcement.
        DELETE
    • 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
      • 搜索大学 / 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.
  • 过时
    • 获取附近店铺
      GET
    • 获取店铺列表
      GET
    • 激活机台
      POST
    • 获取店铺详情
      GET
    • 申请玩家登记令牌
      POST
    • 获取玩家登记信息
      GET
    • 获取在勤人数
      GET
    • 销毁玩家登记令牌
      DELETE
    • 上报在勤人数
      POST
    • 上报机台队列
      POST
    • 数据模型
      • Shop
      • User
      • Game
  1. posts

获取帖子详情。 / Get post details.

GET
/posts/{postId}
获取帖子详情、评论列表，以及当前用户对帖子的投票状态。
Get a post with its comments and the current user vote on the post.

请求参数

Path 参数

请求示例代码

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/posts/'

返回响应

🟢200成功
application/json
OK
Bodyapplication/json

示例
{
    "post": {
        "id": "string",
        "title": "string",
        "content": "string",
        "images": [
            "string"
        ],
        "resolvedImages": [
            {
                "id": "string",
                "shopId": 1,
                "commentId": "string",
                "postId": "string",
                "announcementId": "string",
                "deleteRequestId": "string",
                "userId": "string",
                "universityId": "string",
                "clubId": "string",
                "url": "string",
                "uploadedBy": "string",
                "uploader": {
                    "id": "string",
                    "name": "string",
                    "displayName": "string",
                    "image": "string"
                },
                "uploadedAt": "2019-08-24T14:15:22.123Z"
            }
        ],
        "universityId": "string",
        "clubId": "string",
        "createdBy": "string",
        "createdAt": "2019-08-24T14:15:22.123Z",
        "updatedAt": "2019-08-24T14:15:22.123Z",
        "upvotes": 0,
        "downvotes": 0,
        "commentCount": 0,
        "isPinned": true,
        "isLocked": true,
        "readability": 0,
        "author": {
            "id": "string",
            "name": "string",
            "email": "string",
            "image": "string",
            "avatarImageId": "string",
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z",
            "joinedAt": "2019-08-24T14:15:22.123Z",
            "lastActiveAt": "2019-08-24T14:15:22.123Z",
            "userType": "site_admin",
            "bio": "string",
            "displayName": "string",
            "socialLinks": [
                {
                    "platform": "qq",
                    "username": "string",
                    "verified": true,
                    "userId": "string"
                }
            ],
            "frequentingArcades": [
                -9007199254740991
            ],
            "starredArcades": [
                -9007199254740991
            ]
        }
    },
    "comments": [
        {
            "id": "string",
            "postId": "string",
            "shopId": 1,
            "shopDeleteRequestId": "string",
            "content": "string",
            "images": [
                "string"
            ],
            "resolvedImages": [
                {
                    "id": "string",
                    "shopId": 1,
                    "commentId": "string",
                    "postId": "string",
                    "announcementId": "string",
                    "deleteRequestId": "string",
                    "userId": "string",
                    "universityId": "string",
                    "clubId": "string",
                    "url": "string",
                    "uploadedBy": "string",
                    "uploader": {
                        "id": "string",
                        "name": "string",
                        "displayName": "string",
                        "image": "string"
                    },
                    "uploadedAt": "2019-08-24T14:15:22.123Z"
                }
            ],
            "createdBy": "string",
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z",
            "parentCommentId": "string",
            "upvotes": 0,
            "downvotes": 0,
            "author": {
                "id": "string",
                "name": "string",
                "email": "string",
                "image": "string",
                "avatarImageId": "string",
                "createdAt": "2019-08-24T14:15:22.123Z",
                "updatedAt": "2019-08-24T14:15:22.123Z",
                "joinedAt": "2019-08-24T14:15:22.123Z",
                "lastActiveAt": "2019-08-24T14:15:22.123Z",
                "userType": "site_admin",
                "bio": "string",
                "displayName": "string",
                "socialLinks": [
                    {
                        "platform": "qq",
                        "username": "string",
                        "verified": true,
                        "userId": "string"
                    }
                ],
                "frequentingArcades": [
                    -9007199254740991
                ],
                "starredArcades": [
                    -9007199254740991
                ]
            },
            "vote": {
                "id": "string",
                "commentId": "string",
                "userId": "string",
                "voteType": "upvote",
                "createdAt": "2019-08-24T14:15:22.123Z",
                "updatedAt": "2019-08-24T14:15:22.123Z"
            }
        }
    ],
    "userVote": "upvote"
}
🟠400请求有误
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
🟠409
🟠410记录不存在
🟠429
🔴500服务器错误
🔴502网关错误
修改于 2026-10-24 13:47:28
上一页
更新公告已读状态。 / Update announcement read state.
下一页
更新帖子。 / Update post.
Built with