API Documentation

Comprehensive documentation for developers integrating with our platform via API.

Authentication Endpoints

Authentication

API Key Authentication

Used for all protected endpoints

Access the nmblbnbxa API by sending your API key through the authorization header. Generate a key in your profile settings.

curl -X GET https://api.nmblbnbxa.com/v1/profile -H 'Authorization: Bearer YOUR_api_key_here'
Endpoint: GET /v1/profile
Response: 
{
  "username": "developer",
  "email": "dev@example.com",
  "active": true
}

Endpoints

GET /api/v1/threads

Overview

Retrieve a paginated list of forum threads. You can filter by category, date range, and popularity.

Headers
  • Authorization: Bearer <your_api_key>
  • Accept: application/json
Query Parameters
  • page - Page number (default: 1)
  • limit - Results per page (max: 100)
  • tag - Filter by a specific tag

Example JSON Response

[
  {
    "id": "th-001",
    "title": "How to optimize JavaScript?",
    "author": "jess_dev",
    "category": "performance",
    "created_at": "2025-09-05T10:30:00Z
  },
  {
    "id": "th-002",
    "title": "Best CI/CD Practices",
    "author": "mike_ops",
    "category": "ci-cd",
    "created_at": "2025-09-04T08:45:00z
  }
]
GET /api/v1/threads/{threadId}

Details

Retrieve content of a specific thread. Returns full message history and metadata.

Path Parameters:
  • threadId - Unique identifier of thread

Example

curl -X GET https://api.nmblbnbxa.com/api/v1/threads/th-001 - H 'Authorization: Bearer your_api_key'

Response

{
  "id": "th-001",
  "title": "API Error Solutions",
  "author": "alex_dev",
  "content": "Common API error resolutions...",
  "created_at": "2025-09-10T10:30:00z
}
POST /api/v1/threads

Create Thread

Create a new thread with specified content and category. Requires valid authentication.

Request Body (JSON):
  • title - Required, string
  • content - Required, string
  • category - Optional, string (defaults to general)

Example Request

curl -X POST https://api.nmblbnbxa.com/api/v1/threads -H 'Authorization: Bearer your_api_key' -H 'Content-Type: application/json' -d '{ "title": "API Help Request", "content": "Need help integrating with nmblbnbxa API" }