Aller au contenu

Administration Home News

Contrôleur HTTP de gestion des bandeaux home news (la news affichée sur l'accueil de l'app investisseur). Source : home-news.controller.ts.

Tous les endpoints requièrent une session admin BetterAuth valide (AdminAuthGuard).

POST /administration/home/news

Crée une home news (par défaut inactive). Trace l'action via AdminAction (HOME_NEWS_INSERT).

Source : home-news.controller.ts#L32.

Request body

{
  "name": "Campagne automne 2026",
  "news": {
    "imageUrl": { "desktop": "https://...", "mobile": "https://..." },
    "title": { "fr": "...", "en": "..." },
    "description": { "fr": "...", "en": "..." },
    "callToAction": {
      "text": { "fr": "Découvrir", "en": "Discover" },
      "url": "https://...",
      "shouldOpenInNewTab": true,
      "requireUserIdQueryParam": false
    }
  }
}

Validé via object({ name: string, news: homeNews }) (homeNews depuis @bricks-common/api-communication).

GET /administration/home/news

Liste toutes les home news.

Source : home-news.controller.ts#L44.

Response

Tableau des home news (HomeNewsRepository.getAll).

PUT /administration/home/news/:id/set-active

Active une home news. Désactive d'abord toutes les autres news actives (transactionnel). Trace l'action via AdminAction (HOME_NEWS_SET_ACTIVE).

Source : home-news.controller.ts#L51.

Path param

  • id — UUIDv4

PUT /administration/home/news/:id

Met à jour le contenu d'une home news existante. Trace l'action via AdminAction (HOME_NEWS_UPDATE).

Source : home-news.controller.ts#L65.

Path param

  • id — UUIDv4

Request body

{
  "imageUrl": { "desktop": "https://...", "mobile": "https://..." },
  "title": { "fr": "...", "en": "..." },
  "description": { "fr": "...", "en": "..." },
  "callToAction": {
    "text": { "fr": "Découvrir", "en": "Discover" },
    "url": "https://...",
    "shouldOpenInNewTab": true
  }
}

Validé via homeNews.

DELETE /administration/home/news/:id

Supprime une home news. Refuse la suppression de la news actuellement active. Trace l'action via AdminAction (HOME_NEWS_DELETE).

Source : home-news.controller.ts#L79.

Pré-conditions

  • La news ne doit pas être la news actuellement active

Path param

  • id — UUIDv4

Erreurs

Code Statut Cause
home-news.cannot-delete-active-news 400 Tentative de suppression de la news active

Liens