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

# Swagger UI

> Interactively explore and test all Law4Devs API endpoints in your browser

Swagger UI provides a browser-based interface where you can browse every endpoint,
read its documentation, and make live API calls — all without writing any code.

**URL:** `https://api.law4devs.eu/docs`

## Authenticating in Swagger UI

Before you can use "Try it out", you need to provide your API key:

<Steps>
  <Step title="Open Swagger UI">
    Navigate to `https://api.law4devs.eu/docs` in your browser.
  </Step>

  <Step title="Click Authorize">
    Click the **Authorize** button (lock icon) in the top-right of the page.
  </Step>

  <Step title="Enter your API key">
    In the dialog that appears, paste your API key into the `X-API-Key` field and
    click **Authorize**.

    ```
    X-API-Key: YOUR_API_KEY
    ```
  </Step>

  <Step title="Close and try an endpoint">
    Close the dialog. Expand any endpoint, click **Try it out**, fill in any
    parameters, and hit **Execute**.
  </Step>
</Steps>

## Example: Listing Frameworks

1. Expand `GET /v1/frameworks`
2. Click **Try it out**
3. Set `per_page` to `5`
4. Click **Execute**

You'll see the full request URL, the `curl` command you can copy, and the live
JSON response directly below.

## When to Use Swagger UI

<CardGroup cols={2}>
  <Card title="Prototyping" icon="flask" color="#85EA2D">
    Try endpoints before writing SDK code — verify responses and parameters quickly.
  </Card>

  <Card title="Debugging" icon="bug" color="#ef4444">
    Reproduce API issues interactively to isolate whether the problem is client-side.
  </Card>

  <Card title="Exploration" icon="magnifying-glass" color="#f59e0b">
    Discover all available endpoints and their parameters in one place.
  </Card>

  <Card title="Sharing" icon="share-nodes" color="#3178C6">
    Share a specific endpoint with a colleague by copying the URL from the address bar.
  </Card>
</CardGroup>