API reference

{
  "name": "Mock APIs",
  "version": "1.0.0",
  "description": "Free REST APIs for learning, building, and testing. No API key required.",
  "baseUrl": "https://test.naimulhassan.me/api/v1",
  "documentation": {
    "openapi": "https://test.naimulhassan.me/openapi.json",
    "swaggerUi": "https://test.naimulhassan.me/docs",
    "website": null
  },
  "resources": [
    {
      "name": "users",
      "url": "https://test.naimulhassan.me/api/v1/users",
      "description": "Fictional user profiles with contact details, address, company, and role. Users own posts, todos, comments, carts, and recipes.",
      "writable": true
    },
    {
      "name": "products",
      "url": "https://test.naimulhassan.me/api/v1/products",
      "description": "A fictional product catalog across categories with pricing, discounts, ratings, and stock levels.",
      "writable": true
    },
    {
      "name": "posts",
      "url": "https://test.naimulhassan.me/api/v1/posts",
      "description": "Short blog-style posts written by seeded users, with tags, reactions, and view counts.",
      "writable": true
    },
    {
      "name": "comments",
      "url": "https://test.naimulhassan.me/api/v1/comments",
      "description": "Comments left by users on posts. Every comment references an existing post and user.",
      "writable": true
    },
    {
      "name": "todos",
      "url": "https://test.naimulhassan.me/api/v1/todos",
      "description": "Simple to-do items that belong to users. Ideal for practicing list rendering and toggling state.",
      "writable": true
    },
    {
      "name": "carts",
      "url": "https://test.naimulhassan.me/api/v1/carts",
      "description": "Shopping carts that reference seeded users and products, with computed totals and discounts.",
      "writable": false
    },
    {
      "name": "recipes",
      "url": "https://test.naimulhassan.me/api/v1/recipes",
      "description": "Recipes with ingredients, step-by-step instructions, timings, and nutrition information.",
      "writable": false
    },
    {
      "name": "quotes",
      "url": "https://test.naimulhassan.me/api/v1/quotes",
      "description": "Original, fictional quotes with fictional authors. Read-only.",
      "writable": false
    }
  ],
  "authentication": {
    "login": "https://test.naimulhassan.me/api/v1/auth/login",
    "note": "Demo-only authentication for practice. Never use it to secure real applications."
  },
  "testing": {
    "echo": "https://test.naimulhassan.me/api/v1/test/echo",
    "delay": "https://test.naimulhassan.me/api/v1/test/delay?ms=1000",
    "status": "https://test.naimulhassan.me/api/v1/test/status/404"
  },
  "limits": {
    "defaultPageSize": 30,
    "maxPageSize": 100,
    "maxDelayMs": 5000,
    "rateLimit": {
      "requests": 100000,
      "windowSeconds": 60
    }
  },
  "notice": "POST, PUT, PATCH, and DELETE requests are simulated. They return realistic responses but never modify the shared dataset."
}

{
  "status": "ok",
  "version": "1.0.0",
  "uptimeSeconds": 42,
  "startedAt": "2026-01-01T00:00:00.000Z",
  "database": "connected"
}

{
  "status": "ready",
  "database": "connected"
}

{
  "note": "The full OpenAPI document is returned. Download it from /openapi.json."
}