Swagger Documentation

SOLID automatically generates comprehensive API documentation for all your endpoints using Swagger/OpenAPI specification. This documentation provides developers with an interactive interface to explore and test the APIs.

Accessing API Documentation

To access the Swagger documentation:

1. Navigate to your SOLID installation
2. Go to /api/docs endpoint
3. You'll see the Swagger UI with all available endpoints

Authentication

Before using the APIs, you'll need to authenticate:

1. Use the /api/auth/login endpoint
2. Provide your credentials
3. Receive a JWT token
4. Use this token in the Authorization header for subsequent requests

Example Authentication Flow

# Login request
POST /api/auth/login
{
  "email": "user@example.com",
  "password": "yourpassword"
}

# Response
{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": 1,
    "email": "user@example.com",
    ...
  }
}

# Using the token
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

API Structure

Resource Endpoints

Each resource in your SOLID app automatically gets the following RESTful endpoints:

Query Parameters

The list endpoint supports various query parameters:

Example Requests

List Records with Filtering

GET /api/posts?filters[status]=published&sort=created_at:desc

Create Record

POST /api/posts
{
  "title": "New Post",
  "content": "Post content",
  "status": "draft"
}

Update Record

PUT /api/posts/1
{
  "status": "published"
}

Error Handling

All API errors follow a consistent format:

{
  "error": {
    "status": 400,
    "name": "ValidationError",
    "message": "Title is required",
    "details": {
      "fields": {
        "title": ["This field is required"]
      }
    }
  }
}

Common Error Codes

Best Practices