🚀 FreeFakeAPI

What is this API?

This is a complete, production-ready REST API that you can use for free to build your e-commerce applications. Whether you're building a web application, mobile app, or integrating e-commerce functionality into an existing system, this API provides all the endpoints you need.

The API is built using modern technologies and follows best practices, ensuring reliability, scalability, and security. It includes authentication, authorization, data validation, and comprehensive error handling.

✨ Key Features

🔗 API Endpoints

Complete RESTful API with endpoints for all operations:

🚀 Getting Started

Follow these simple steps to start using the API:

1. Get Your API Base URL

   Use our hosted API: https://freefakeapi.com

2. Register a User Account

   Create an account to get your authentication token:

   POST /api/auth/register
   {
     "name": "John Doe",
     "email": "[email protected]",
     "password": "password123"
   }

3. Login to Get Your Token

   Login with your credentials to receive a JWT token:

   POST /api/auth/login
   {
     "email": "[email protected]",
     "password": "password123"
   }
   
   // Response includes a token - save this for authenticated requests

4. Make Authenticated Requests

   Include your token in the Authorization header for protected endpoints:

   Headers:
   Authorization: Bearer YOUR_JWT_TOKEN_HERE
   
   GET /api/products

5. Explore the API

   Use the interactive Swagger documentation to test endpoints and see examples:

   Open API Documentation

💻 Usage Examples

Here are some common use cases:

fetch('http://localhost:3000/api/products')
  .then(res => res.json())
  .then(data => console.log(data));

fetch('http://localhost:3000/api/products?search=iPhone&page=1&limit=10&sortBy=price&sortOrder=asc')
  .then(res => res.json())
  .then(data => {
    // data.data contains products
    // data.pagination contains pagination info
    console.log(data);
  });

fetch('http://localhost:3000/api/orders', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  },
  body: JSON.stringify({
    items: [
      { product: 'productId', quantity: 2 }
    ],
    shippingAddress: {
      street: '123 Main St',
      city: 'New York',
      state: 'NY',
      zipCode: '10001',
      country: 'USA'
    }
  })
})

🛠️ Built With