v51

latestSwagger 2.0Apache 2.0raw.githubusercontent.com2026-08-018357145.6 KB

Hole

Create A Hole

Create a hole, create tags and floor binding to it and set the name mapping

post/divisions/{division_id}/holes

Path parameters

division_idinteger required

division id

Request body

contentstring required

special_tagstring

Admin and Operator only

Response

Created

ai_summary_availableboolean

AI 摘要可用性，仅用于序列化

division_idinteger

所属 division 的 id

favorite_countinteger

frozenboolean

冻结状态，仅管理员可见 true FrozenFrontend *bool json:"frozen,omitempty" gorm:"-:all" FrozenFrontend *bool json:"frozen" gorm:"-:all" Compatibility for Swift client

goodboolean

hiddenboolean

是否隐藏，隐藏的洞用户不可见，管理员可见

hole_idinteger

兼容旧版 id

idinteger

/ saved fields

lockedboolean

锁定帖子，如果锁定则非管理员无法发帖，也无法修改已有发帖

no_purgeboolean

replyinteger

回复量（即该洞下 floor 的数量 - 1）

subscription_countinteger

time_createdstring

time_updatedstring

viewinteger

浏览量