---
title: "Categories (Discourse)"
description: "Categories"
language: fr
source_language: en
translation_state: pending
canonical: https://documentation.invantive.eu/fr/datamodels/discourse/Discourse.Categories.Categories
original: https://documentation.invantive.eu/en/datamodels/discourse/Discourse.Categories.Categories
updated: 2026-11-16T20:47:00Z
license: https://documentation.invantive.eu/fr/
---

# Categories: Discourse Categories

`read only` `REST`

- Catalogue : `Discourse`
- Schéma : `Categories`
- Label: Categories

Get a list of categories The Categories endpoint returns a list of all the categories for your discourse site that you have access to.

Permet uniquement de récupérer des données.

## Résumé

The Categories endpoint returns a list of all the categories for your discourse site that you have access to.

## Source de l'API

- Point de terminaison : `/categories.json`
- Opération : `get /categories.json`

## Caractéristiques de performance

| Characteristic | Value |
|---|---:|
| Latence moyenne d'accès (ms) | 243 |
| Nombre d'enregistrements écrits par minute | 219 |

Le résultat peut être mis en cache côté client.

## Colonnes de table

Les colonnes de la table `Categories` sont présentées ci-dessous. Chaque colonne possède un type de données SQL. Une nouvelle valeur non nulle doit être fournie pour chaque colonne requise à tout moment lors de l'insertion et de la mise à jour.

| Name | Type de données | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `background_url` | `varchar2` | URL d'origine | [ ] | writable, `background_url` |  |
| `can_create_category` | `char` | Permet de créer une catégorie | [ ] | filters on the platform, writable, `::ancestor.can_create_category` |  |
| `can_create_topic` | `char` | Peut créer un sujet | [ ] | filters on the platform, writable, `::ancestor.can_create_topic` |  |
| `can_edit` | `char` | peut modifier | [ ] | writable, `can_edit` |  |
| `can_vote` | `char` | Peut voter | [ ] | filters on the platform, writable, `can_vote` |  |
| `color` | `varchar2` | Colour | [ ] | writable, `color` |  |
| `default_list_filter` | `varchar2` | Filtre par défaut de la liste | [ ] | filters on the platform, writable, `default_list_filter` |  |
| `default_top_period` | `varchar2` | Période par défaut | [ ] | filters on the platform, writable, `default_top_period` |  |
| `default_view` | `varchar2` | View par défaut | [ ] | filters on the platform, writable, `default_view` |  |
| `description` | `varchar2` | Description | [ ] | writable, `description` |  |
| `description_excerpt` | `varchar2` | Extrait de la description | [ ] | writable, `description_excerpt` |  |
| `description_text` | `varchar2` | Texte de description | [ ] | writable, `description_text` |  |
| `draft` | `char` | Draft | [ ] | filters on the platform, writable, `::ancestor.draft` |  |
| `draft_key` | `varchar2` | Clavette d'attelage | [ ] | filters on the platform, writable, `::ancestor.draft_key` |  |
| `draft_sequence` | `int64` | Séquence de brouillon | [ ] | filters on the platform, writable, `::ancestor.draft_sequence` |  |
| `has_children` | `char` | A des enfants | [ ] | writable, `has_children` |  |
| `id` | `int64` | ID | [ ] | writable, `id` |  |
| `is_uncategorized` | `char` | Est-ce « Non classé » ? | [ ] | filters on the platform, writable, `is_uncategorized` |  |
| `logo_url` | `varchar2` | URL du logo | [ ] | writable, `logo_url` |  |
| `minimum_required_tags` | `int32` | Balises minimales requises | [ ] | filters on the platform, writable, `minimum_required_tags` |  |
| `name` | `varchar2` | Name | [ ] | writable, `name` |  |
| `navigate_to_first_post_after_read` | `char` | Aller au premier message après la lecture | [ ] | filters on the platform, writable, `navigate_to_first_post_after_read` |  |
| `notification_level` | `varchar2` | Niveau de notification | [ ] | writable, `notification_level` |  |
| `num_featured_topics` | `int32` | Nombre de sujets à la une | [ ] | filters on the platform, writable, `num_featured_topics` |  |
| `permission` | `int64` | Permission | [ ] | writable, `permission` |  |
| `position` | `int64` | Position | [ ] | writable, `position` |  |
| `post_count` | `int64` | #Posts | [ ] | writable, `post_count` |  |
| `read_restricted` | `char` | Accès restreint | [ ] | writable, `read_restricted` |  |
| `show_subcategory_list` | `char` | Afficher la liste des sous-catégories | [ ] | filters on the platform, writable, `show_subcategory_list` |  |
| `slug` | `varchar2` | Slug | [ ] | writable, `slug` |  |
| `sort_order` | `varchar2` | Ordre de tri | [ ] | filters on the platform, writable, `sort_order` |  |
| `subcategory_list_style` | `varchar2` | Style de la liste des sous-catégories | [ ] | filters on the platform, writable, `subcategory_list_style` |  |
| `text_color` | `varchar2` | Couleur du texte | [ ] | writable, `text_color` |  |
| `topic_count` | `int64` | #Topics | [ ] | writable, `topic_count` |  |
| `topic_template` | `varchar2` | Modèle de sujet | [ ] | writable, `topic_template` |  |
| `topic_url` | `varchar2` | URL du sujet | [ ] | writable, `topic_url` |  |
| `topics_all_time` | `int64` | Thèmes de tous les temps | [ ] | writable, `topics_all_time` |  |
| `topics_day` | `int64` | Journée thématique | [ ] | writable, `topics_day` |  |
| `topics_month` | `int64` | Thèmes du mois | [ ] | writable, `topics_month` |  |
| `topics_week` | `int64` | Semaine thématique | [ ] | writable, `topics_week` |  |
| `topics_year` | `int64` | Thèmes Année | [ ] | writable, `topics_year` |  |
| `uploaded_logo_height` | `int32` | Hauteur du logo téléchargé | [ ] | filters on the platform, writable, `uploaded_logo.height` |  |
| `uploaded_logo_id` | `int32` | Logo ID téléchargé | [ ] | filters on the platform, writable, `uploaded_logo.id` |  |
| `uploaded_logo_url` | `varchar2` | URL du logo téléchargé | [ ] | filters on the platform, writable, `uploaded_logo.url` |  |
| `uploaded_logo_width` | `int32` | Largeur du logo téléchargé | [ ] | filters on the platform, writable, `uploaded_logo.width` |  |

## Référencée

- [Posts](Discourse.Posts.Posts) `category_id` (Candidate)
- [Posts_Latest_postsActions_summary](Discourse.Posts.Posts_Latest_postsActions_summary) `category_id` (Candidate)
- [Top_Topic_listTopics](Discourse.Topics.Top_Topic_listTopics) `category_id` (Candidate)
- [Top_Topic_listTopicsPosters](Discourse.Topics.Top_Topic_listTopicsPosters) `category_id` (Candidate)


## Notes de Version

Quels ont été les changements apportés à chaque version au niveau des tables, des colonnes, des attributs et des fonctionnalités du chauffeur :

- [Discourse](/fr/release-notes/drivers?driver=discourse)

### Modifications apportées à cette table, 26.0 à 27.0

<div class="rn-item" id="DCE-27.0-D1074">

##### Discourse.Categories.Categories : modifications de type

Le type de « Discourse.Categories.Categories » passe de « Table » à « Tablefunction ».

<div class="rn-action">

**Que faire ?**

Vérifiez les instructions, les Views et les scripts qui l'utilisent avant la mise à niveau.

</div>

<div class="rn-chips">

- **peut interrompre une instruction**
- `table` &rarr; `tablefunction`
- importance 3

</div>

</div>

<a id="DCE-27.0-D106"></a><a id="DCE-27.0-D107"></a><a id="DCE-27.0-D108"></a><a id="DCE-27.0-D109"></a><a id="DCE-27.0-D110"></a><a id="DCE-27.0-D111"></a><a id="DCE-27.0-D112"></a><a id="DCE-27.0-D113"></a><a id="DCE-27.0-D114"></a><a id="DCE-27.0-D115"></a><a id="DCE-27.0-D116"></a><a id="DCE-27.0-D1420"></a><a id="DCE-27.0-D1421"></a><a id="DCE-27.0-D1422"></a>

- `-` `background_url`
- `-` `draft`
- `-` `draft_key`
- `-` `draft_sequence`
- `-` `logo_url`
- `~` `minimum_required_tags` (`database_data_type`: `int32` &rarr; `int64`)
- `~` `minimum_required_tags` (`dotnet_data_type`: `int32` &rarr; `int64`)
- `~` `notification_level` (`database_data_type`: `varchar2` &rarr; `int64`)
- `~` `notification_level` (`dotnet_data_type`: `string` &rarr; `int64`)
- `~` `num_featured_topics` (`database_data_type`: `int32` &rarr; `int64`)
- `~` `num_featured_topics` (`dotnet_data_type`: `int32` &rarr; `int64`)
- `+` `emoji` (`varchar2`)
- `+` `icon` (`varchar2`)
- `+` `sort_ascending` (`varchar2`)

<details>
<summary>

8 modifications supplémentaires

</summary>

<div class="rn-item" id="DCE-27.0-D2375">

##### Le paramètre include_subcategories a été ajouté à Discourse.Categories.Categories

Facultatif.

<div class="rn-chips">

- importance 2

</div>

</div>

<a id="DCE-27.0-D1423"></a><a id="DCE-27.0-D1424"></a><a id="DCE-27.0-D1425"></a><a id="DCE-27.0-D1426"></a><a id="DCE-27.0-D1427"></a><a id="DCE-27.0-D1428"></a><a id="DCE-27.0-D1429"></a>

- `+` `style_type` (`varchar2`)
- `+` `subcategory_count` (`int64`)
- `+` `topic_title_placeholder` (`varchar2`)
- `+` `uploaded_background` (`varchar2`)
- `+` `uploaded_background_dark` (`varchar2`)
- `+` `uploaded_logo` (`varchar2`)
- `+` `uploaded_logo_dark` (`varchar2`)

</details>

[Toutes les modifications apportées au chauffeur, 26.0 à 27.0](/fr/release-notes/drivers?driver=discourse&step=26.0-to-27.0#discourse-26.0-to-27.0)
