> ## Documentation Index
> Fetch the complete documentation index at: https://docs.craftingstudiopro.de/llms.txt
> Use this file to discover all available pages before exploring further.

# REST API Basics

> Learn how to interact programmatically with the CraftingStudio Pro backend

## Base URL

All API requests are made to the following base URL:

```http theme={null}
https://api.craftingstudiopro.de/v1
```

## Response Format

Our API follows modern REST principles and delivers consistent JSON data.

<CardGroup cols={2}>
  <Card title="Success Response" icon="check">
    ```json theme={null}
    {
      "success": true,
      "data": {
        "id": 1,
        "title": "My Plugin",
        "version": "1.0.0"
      }
    }
    ```
  </Card>

  <Card title="Error Response" icon="xmark">
    ```json theme={null}
    {
      "success": false,
      "message": "Plugin not found or invalid ID."
    }
    ```
  </Card>
</CardGroup>

## Pagination

Endpoints that return lists (such as `/plugins`) use `limit` and `offset` for pagination.

| Parameter | Default | Max   | Description                                 |
| :-------- | :------ | :---- | :------------------------------------------ |
| `limit`   | `100`   | `500` | Maximum number of results to return.        |
| `offset`  | `0`     | -     | Number of results to skip at the beginning. |

### Example Request

```bash theme={null}
curl -X GET "https://api.craftingstudiopro.de/v1/plugins?limit=25&offset=50"
```