Flamenet REST API

The Flamenet API provides programmatic access to the Forum, Answers, Shop, and Marketplace features. All endpoints return JSON.

Base URL

https://flamenet.io/wp-json/flamenet/v1

All endpoints are relative to this base. HTTPS is required.

Authentication

API Key

Some endpoints require authentication. Authenticate by including your API key in every request.

Get your API key

  1. Sign in to your Flamenet account.
  2. Go to your Profile page.
  3. Scroll to the API Access section.
  4. Click Generate New Key.
  5. Copy and store the key securely — it is only shown once in full.

Authorization: Bearer header (recommended)

curl https://flamenet.io/wp-json/flamenet/v1/forum/boards \
  -H "Authorization: Bearer YOUR_API_KEY"

Query parameter (testing)

https://flamenet.io/wp-json/flamenet/v1/forum/boards?api_key=YOUR_API_KEY
Never expose your API key in client-side JavaScript or public repositories.

Endpoints Overview

Forum /forum

MethodPathAuthDescription
GET/forum/boardsNoList all forum boards
GET/forum/boards/{id}NoBoard details + paginated topics
GET/forum/topics/{id}NoTopic details + paginated replies
POST/forum/topicsYesCreate a new topic
POST/forum/topics/{id}/repliesYesPost a reply

Answers /answers

MethodPathAuthDescription
GET/answers/questionsNoList questions with filters
GET/answers/questions/{id}NoQuestion details + answers
POST/answers/questionsYesAsk a question
POST/answers/questions/{id}/answersYesSubmit an answer
POST/answers/answers/{id}/voteYesVote on an answer

Shop /shop

MethodPathAuthDescription
GET/shop/productsNoList catalog products
GET/shop/products/{id}NoProduct details
GET/shop/ordersYesYour order history

Marketplace /marketplace

MethodPathAuthDescription
GET/marketplace/storesNoList active storefronts
GET/marketplace/stores/{slug}NoStore details + products
GET/marketplace/productsNoList all products across stores
GET/marketplace/products/{id}NoProduct details
GET/marketplace/ordersYesYour marketplace order history

HTTP Status Codes

CodeMeaning
200 OKRequest succeeded.
201 CreatedResource created successfully.
400 Bad RequestMalformed request or invalid parameters.
401 UnauthorizedMissing or invalid API key.
403 ForbiddenAuthenticated but not permitted (e.g. locked topic).
404 Not FoundResource does not exist.
422 UnprocessableMissing required fields in POST body.
500 Server ErrorUnexpected error. Contact support.
503 UnavailableRequired plugin is not active.

Error Response Format

All errors follow the WordPress REST API error format:

{
  "code":    "unauthorized",
  "message": "Valid API key required.",
  "data":    { "status": 401 }
}