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

# Catégories de menus

> Lisez les catégories de menus de restaurant avec pagination et produits facultatifs.

Utilisez les catégories de menu API pour afficher la navigation par catégorie ou les pages de destination de catégorie.

```text theme={null}
GET /api/public/menu/categories
```

Ce point de terminaison attend actuellement la clé API dans la chaîne de requête.

## Exemple

```bash theme={null}
curl "https://api.plato.ae/api/public/menu/categories?apiKey=$PLATO_API_KEY&includeProducts=true"
```

## Paramètres de requête

| Paramètre         | Taper             | Défaut      | Remarques                                             |
| ----------------- | ----------------- | ----------- | ----------------------------------------------------- |
| `apiKey`          | chaîne            | requis      | Clé Plato API.                                        |
| `search`          | chaîne            | aucune      | Recherchez les noms de catégories.                    |
| `slug`            | chaîne            | aucune      | Récupérez une catégorie par slug exact.               |
| `ids`             | liste de virgules | aucune      | Récupérez les identifiants de catégories spécifiques. |
| `sortBy`          | chaîne            | `createdAt` | `name`, `createdAt`, `updatedAt` ou `slug`.           |
| `sortOrder`       | chaîne            | `desc`      | `asc` ou `desc`.                                      |
| `page`            | nombre            | `1`         | Numéro de page.                                       |
| `limit`           | nombre            | `20`        | `1` minimum, `100` maximum.                           |
| `includeProducts` | booléenne         | `false`     | Incluez les produits publiés dans chaque catégorie.   |

## Réponse

```json theme={null}
{
  "data": [
    {
      "id": "category_123",
      "slug": "burgers",
      "name": {
        "en": "Burgers"
      },
      "description": null,
      "thumbnail": null,
      "smallThumbnail": null,
      "showcase": null,
      "productsCount": 12,
      "products": [
        {
          "id": "product_123",
          "slug": "classic-burger",
          "name": {
            "en": "Classic Burger"
          },
          "priceOptions": [],
          "published": true,
          "soldout": false
        }
      ],
      "createdAt": "2026-06-17T08:20:00.000Z",
      "updatedAt": "2026-06-17T09:15:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 5,
    "totalPages": 1,
    "hasMore": false
  }
}
```

`products` n'est inclus que lorsque `includeProducts=true`.

## Remarques

* Les produits inclus sont des produits publiés.
* Utilisez `includeProducts=false` pour les menus de navigation.
* Utilisez `includeProducts=true` pour les pages de catégorie qui nécessitent immédiatement la première liste de produits.