Skip to main content

Documentation Index

Fetch the complete documentation index at: https://yorber.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

All internal microservices (except public routes) are protected by a centralized authentication system. Clients must first obtain a JSON Web Token (JWT) via the API Gateway.

​
Login & Get Token

POST /api/auth/login
Content-Type: application/json

{
  "username": "user1",
  "password": "pass123"
}

{
  "error": false,
  "status": 200,
  "body": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

​
Posts Service

The Content Service handles all post-related logic, interacting with the DB Service securely behind the scenes.

​
Create a New Post

Requires Authentication: Include the JWT in the Authorization header. 
POST /api/posts
Authorization: Bearer <your-jwt-token>
Content-Type: application/json

{
  "content": "Hello world! This is my first post from the Microservices API."
}

{
  "error": false,
  "status": 201,
  "body": {
    "id": 1,
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "user_id": 1,
    "content": "Hello world! This is my first post from the Microservices API.",
    "created_at": "2026-04-07T10:00:00.000Z"
  }
}

​
Likes Service

Independent service dedicated to handling user interactions with posts.

​
Like a Post

Requires Authentication: Include the JWT in the Authorization header. 
POST /api/likes
Authorization: Bearer <your-jwt-token>
Content-Type: application/json

{
  "post_id": 1
}

{
  "error": false,
  "status": 201,
  "body": {
    "id": 1,
    "user_id": 1,
    "post_id": 1,
    "created_at": "2026-04-07T10:05:00.000Z"
  }
}