Forum API

Returns all forum boards with cached statistics.

Example request

curl https://flamenet.io/wp-json/flamenet/v1/forum/boards

Example response

[
  {
    "id":             1,
    "title":          "General Discussion",
    "description":   "Talk about anything.",
    "topic_count":   42,
    "post_count":    156,
    "last_post_time":"2026-03-01 14:22:00",
    "last_post_user":"JohnDoe"
  },
  ...
]

Returns board details and a paginated list of topics (stickies first).

Query parameters

Parameter	Type	Default	Description
page	integer	1	Page number for topic pagination.

Example request

curl "https://flamenet.io/wp-json/flamenet/v1/forum/boards/1?page=2"

Example response

{
  "board":  { "id": 1, "title": "General Discussion", ... },
  "topics": [
    {
      "id":             5,
      "title":          "Welcome to Flamenet!",
      "author_id":     2,
      "author":         "Admin",
      "reply_count":   12,
      "is_sticky":     true,
      "is_locked":     false,
      "created_at":    "2026-01-01T00:00:00+00:00",
      "last_reply":    "2026-02-28 09:14:00",
      "last_reply_user":"JaneSmith"
    }
  ],
  "page":  2,
  "pages": 5,
  "total": 83
}

Returns topic details and a paginated list of replies (oldest first).

Query parameters

Parameter	Type	Default	Description
page	integer	1	Page number for reply pagination.

Example request

curl "https://flamenet.io/wp-json/flamenet/v1/forum/topics/5"

Example response

{
  "topic": {
    "id":          5,
    "title":       "Welcome to Flamenet!",
    "content":     "Hello everyone...",
    "author_id":  2,
    "author":      "Admin",
    "board_id":   1,
    "board_title":"General Discussion",
    "reply_count":12,
    "is_sticky":  true,
    "is_locked":  false,
    "created_at": "2026-01-01T00:00:00+00:00",
    "last_reply": "2026-02-28 09:14:00"
  },
  "replies": [
    {
      "id":        23,
      "content":  "Thanks for the warm welcome!",
      "author_id":5,
      "author":   "JaneSmith",
      "created_at":"2026-01-02T11:00:00+00:00"
    }
  ],
  "page":  1,
  "pages": 2,
  "total": 12
}

Creates a new topic in the specified board.

Request body (JSON)

Field	Type	Required	Description
board_id	integer	Yes	ID of the board to post in.
title	string	Yes	Topic title (max 200 chars).
content	string	Yes	Topic body text.

Example request

curl -X POST https://flamenet.io/wp-json/flamenet/v1/forum/topics \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"board_id":1,"title":"My first topic","content":"Hello Flamenet!"}'

Example response — 201 Created

{
  "id":       88,
  "title":    "My first topic",
  "board_id": 1,
  "author":   "YourUsername"
}

Posts a reply to the specified topic. Returns 403 if the topic is locked.

Request body (JSON)

Field	Type	Required	Description
content	string	Yes	Reply body text.

Example request

curl -X POST https://flamenet.io/wp-json/flamenet/v1/forum/topics/5/replies \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"Great post, thanks!"}'

Example response — 201 Created

{
  "id":       102,
  "topic_id": 5,
  "author":   "YourUsername"
}