Flamenet REST API
The Flamenet API provides programmatic access to the Forum, Answers, Marketplace, and Files features. All endpoints return JSON.
Base URL
https://flamenet.io/api/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
- Sign in to your Flamenet account.
- Go to your Profile page.
- Scroll to the API Access section.
- Click Generate New Key.
- Copy and store the key securely — it is only shown once in full.
Authorization: Bearer header (recommended)
curl https://flamenet.io/api/flamenet/v1/forum/boards \ -H "Authorization: Bearer YOUR_API_KEY"
Query parameter (testing)
https://flamenet.io/api/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
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /forum/boards | No | List all forum boards |
| GET | /forum/boards/{id} | No | Board details + paginated topics |
| GET | /forum/topics/{id} | No | Topic details + paginated replies |
| POST | /forum/topics | Yes | Create a new topic |
| POST | /forum/topics/{id}/replies | Yes | Post a reply |
Answers /answers
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /answers/questions | No | List questions with filters |
| GET | /answers/questions/{id} | No | Question details + answers |
| POST | /answers/questions | Yes | Ask a question |
| POST | /answers/questions/{id}/answers | Yes | Submit an answer |
| POST | /answers/answers/{id}/vote | Yes | Vote on an answer |
Marketplace /marketplace
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /marketplace/stores | No | List active storefronts |
| GET | /marketplace/stores/{slug} | No | Store details + products |
| GET | /marketplace/products | No | List all products across stores |
| GET | /marketplace/products/{id} | No | Product details |
| GET | /marketplace/orders | Yes | Your marketplace order history |
Files /files
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /files | Yes | List your files (paginated) |
| POST | /files | Yes | Upload a file (multipart/form-data) |
| GET | /files/{id} | Yes | Get file metadata |
| DELETE | /files/{id} | Yes | Delete a file |
| PATCH | /files/{id}/rename | Yes | Rename a file |
| POST | /files/{id}/share | Yes | Create or update a share link |
| DELETE | /files/{id}/share | Yes | Remove a share link |
| GET | /files/{id}/download | Yes | Get a presigned download URL |
Video /videos
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /videos | No | List public videos (paginated) |
| POST | /videos | Yes | Upload a video (multipart/form-data) |
| GET | /videos/{id} | No | Get video details |
| DELETE | /videos/{id} | Yes | Delete own video |
| POST | /videos/{id}/rate | Yes | Like or dislike a video |
| GET | /videos/{id}/comments | No | List comments (paginated) |
| POST | /videos/{id}/comments | Yes | Post a comment |
| GET | /videos/{id}/stream | No* | Get a presigned stream URL (24h) |
| POST | /videos/{id}/share | Yes | Create a share link |
| DELETE | /videos/{id}/share | Yes | Remove a share link |
HTTP Status Codes
| Code | Meaning |
|---|---|
| 200 OK | Request succeeded. |
| 201 Created | Resource created successfully. |
| 400 Bad Request | Malformed request or invalid parameters. |
| 401 Unauthorized | Missing or invalid API key. |
| 403 Forbidden | Authenticated but not permitted (e.g. locked topic). |
| 404 Not Found | Resource does not exist. |
| 422 Unprocessable | Missing required fields in POST body. |
| 500 Server Error | Unexpected error. Contact support. |
| 503 Unavailable | Required 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 }
}