# Catalog routes

The catalog routes of games-api, with parameters, bodies, responses and request samples.

Generated from `openapi.yaml` of games-api 0.7.0: 2 routes.

- [`GET /v1/catalog/{site}`](#get-v1-catalog-site): Full catalog of a site
- [`GET /v1/catalog/{site}/games/{slug}`](#get-v1-catalog-site-games-slug): One game of a site

<RouteHeading id="get-v1-catalog-site" method="GET" path="/v1/catalog/{site}" />

<CodePanel title="GET /v1/catalog/{site}">
  <Fragment slot="curl">

    ```sh
    curl 'https://api.filudi.com/v1/catalog/filudi'
    ```

  </Fragment>
  <Fragment slot="javascript">

    ```js
    const response = await fetch('https://api.filudi.com/v1/catalog/filudi');
    const data = await response.json();
    ```

  </Fragment>
  <Fragment slot="python">

    ```py
    import requests

    response = requests.get('https://api.filudi.com/v1/catalog/filudi')
    response.raise_for_status()
    data = response.json()
    ```

  </Fragment>
</CodePanel>

**Full catalog of a site**

Credential: none. The route is public.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `site` | path | string | yes | Site slug |
| `locale` | query | string | no | Returns texts for one locale only; default returns every locale of the site |

### Responses

| Status | Body | Description |
| --- | --- | --- |
| 200 | [Catalog](/docs/api/reference/schemas/#schema-catalog) | Catalog. Headers: `Cache-Control`, `ETag`. |
| 304 | none | Not modified. |
| 404 | [Error](/docs/api/reference/schemas/#schema-error) | Unknown resource. |

<RouteHeading id="get-v1-catalog-site-games-slug" method="GET" path="/v1/catalog/{site}/games/{slug}" />

<CodePanel title="GET /v1/catalog/{site}/games/{slug}">
  <Fragment slot="curl">

    ```sh
    curl 'https://api.filudi.com/v1/catalog/filudi/games/gloop'
    ```

  </Fragment>
  <Fragment slot="javascript">

    ```js
    const response = await fetch('https://api.filudi.com/v1/catalog/filudi/games/gloop');
    const data = await response.json();
    ```

  </Fragment>
  <Fragment slot="python">

    ```py
    import requests

    response = requests.get('https://api.filudi.com/v1/catalog/filudi/games/gloop')
    response.raise_for_status()
    data = response.json()
    ```

  </Fragment>
</CodePanel>

**One game of a site**

Credential: none. The route is public.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `site` | path | string | yes | Site slug |
| `slug` | path | string | yes |  |

### Responses

| Status | Body | Description |
| --- | --- | --- |
| 200 | [CatalogGame](/docs/api/reference/schemas/#schema-cataloggame) | Game. |
| 404 | [Error](/docs/api/reference/schemas/#schema-error) | Unknown resource. |