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

# Public Silo

> Guide on how to manage a public silo

## Introduction

This page is a guide on how to manage a public silo, how to use it in your project, and some basic use cases that you can do with it.

#### Use Case

* API mockups / Frontend data mockups.
* Sharing JSON files (e.g., JSON configuration files, assets, raw data).

### Base URL

**Default Base URL**

```
https://api.jsonsilo.com/
```

**Region-Base URL**

```
https://[region-code].jsonsilo.com/
```

| Region                  | Code         | Example                            | Free Plan | Paid Plan |
| ----------------------- | ------------ | ---------------------------------- | --------- | --------- |
| Germany (Dusseldorf)    | `api`        | `https://api.jsonsilo.com/`        | ✅         | ✅         |
| Singapore               | `sg-01-api`  | `https://sg-01-api.jsonsilo.com/`  | ❌         | ✅         |
| United States (Central) | `usc-01-api` | `https://usc-01-api.jsonsilo.com/` | ❌         | ✅         |

### Basic usage

<Warning>Please ensure that `/public/` is included; otherwise, it will assume a private silo.</Warning>

<CodeGroup>
  ```curl CLI (cURL) theme={null}
  curl -X GET \
      -H 'Content-Type: application/json' \
      https://api.jsonsilo.com/public/4df8d9d5-38cc-49e5-9f08-15d2819742fb
  ```

  ```python main.py (Python) theme={null}
   # pip install requests

    import requests 

    url = 'https://api.jsonsilo.com/public/4df8d9d5-38cc-49e5-9f08-15d2819742fb'
      headers = {
        'Content-Type': 'application/json'
      }
    response = requests.get(url, headers=headers)
    print(response.text)
  ```

  ```javascript main.js (JavaScript) theme={null}
   // npm install axios

    const url = 'https://api.jsonsilo.com/public/4df8d9d5-38cc-49e5-9f08-15d2819742fb';
    const headers = {
        'Content-Type': 'application/json'
    };

    axios.get(url, { headers: headers })
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error('There was an error with the request:', error);
    });
  ```
</CodeGroup>

## Supported HTTP method

* **GET** only

## Access Key

An access key is **NOT** required for a public silo

## Request Limit

There is no request limit.