OPopentreehole
Hole

API for Listing Holes

Changed on
get/holes

Request

  • Base URL
    /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/holes
  • Auth
    none declared

Query parameters

created_endstring
created_startstring
division_idinteger
lengthinteger
offsetstring
orderstring
sizeinteger
start_timestring
tagstring
tagsstring[]

Response

OK

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

浏览量

Changes

  • c9328768225bRevision changes
    • info

      endpoint reactivated

    • info

      added the new optional query request parameter created_end

    • info

      added the new optional query request parameter created_start

    • info

      added the new optional query request parameter offset

    • info

      added the new optional query request parameter size

    • info

      added the new optional query request parameter tags

  • 433e4a186e4bRevision changes
    • warning

      deleted the query request parameter created_end

    • warning

      deleted the query request parameter created_start

    • warning

      deleted the query request parameter offset

    • warning

      deleted the query request parameter size

    • warning

      deleted the query request parameter tags

    • info

      endpoint deprecated