API Reference - Acme Corp

User Management

This section details endpoints for managing user accounts.

Create User

Endpoint: /api/v1/users

Method: POST

Description: Creates a new user account.

Request Body:

{
                "firstName": "string",
                "lastName": "string",
                "email": "string",
                "password": "string"
            }

Response (Success): 201 Created - Returns the newly created user object.

Get User

Endpoint: /api/v1/users/{user_id}

Method: GET

Description: Retrieves a user by their ID.

Response (Success): 200 OK - Returns the user object.

Response (Error): 404 Not Found - User not found.

Product Catalog

This section describes endpoints related to the product catalog.

Get Products

Endpoint: /api/v1/products

Method: GET

Description: Retrieves a list of all products.

Query Parameters:

category: (Optional) Filters products by category.
limit: (Optional) Limits the number of products returned.

Response (Success): 200 OK - Returns an array of product objects.

Response (Empty): 200 OK - Returns an empty array if no products match the criteria.