PRODUCT API DOCUMENTATION
=========================

Authentication
--------------
All API requests require an API key in the header:
Authorization: Bearer YOUR_API_KEY

Endpoints
---------

GET /api/products
List all products
Query parameters:
  - category: Filter by category
  - limit: Max results (default: 50)
  - offset: Pagination offset

Response:
{
  "products": [
    {
      "id": "prod_123",
      "name": "Product Name",
      "price": 29.99,
      "category": "electronics",
      "stock": 100
    }
  ],
  "total": 500,
  "has_more": true
}

POST /api/products
Create a new product
Request body:
{
  "name": "Product Name",
  "description": "Product description",
  "price": 29.99,
  "category": "electronics",
  "stock": 100,
  "sku": "PROD-001"
}

Response: 201 Created
{
  "id": "prod_124",
  "name": "Product Name",
  ...
}

PUT /api/products/{id}
Update existing product
Request body: Same as POST
Response: 200 OK

DELETE /api/products/{id}
Delete a product
Response: 204 No Content

Error Responses
---------------
400 Bad Request: Invalid parameters
401 Unauthorized: Invalid API key
404 Not Found: Resource doesn't exist
429 Too Many Requests: Rate limit exceeded (max 100 requests/min)
500 Internal Server Error: Server error

Rate Limits
-----------
- Free tier: 100 requests/min
- Pro tier: 1000 requests/min
- Enterprise: Custom limits

Contact: api-support@example.com
