Introduction

{% embed url="https://www.youtube.com/watch?v=6_wfq76CG6g" fullWidth="false" %}

Welcome to the Blog API documentation! This API provides functionalities for managing blog posts, users, comments, and likes.

Base URL

All API endpoints are relative to the following base URL: /api/v1

For example, the user registration endpoint is /api/v1/auth/register.

Overview

• API Version: 1.0.0
• Authentication: Uses JWT Bearer tokens for access and JWT refresh tokens (via HTTP-only cookies) for session renewal.
• Authorization: Role-based access control ('admin', 'user'). Specific roles are required for certain endpoints.
• Rate Limiting: Applied globally (60 requests per minute per IP). Exceeding the limit returns a 429 Too Many Requests error.
• Input Validation: Uses express-validator. Invalid requests return detailed 400 Bad Request errors.
• Content Format: Primarily JSON (application/json). File uploads use multipart/form-data.