# API Updates Portal

> URL: https://foura.ai/fr/docs/updates-portal/api
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

Le portail des mises à jour expose une petite API JSON publique vous permettant d'interroger le statut, d'intégrer les entrées du changelog, de suivre la roadmap et de vérifier les problèmes connus depuis vos propres systèmes. Aucune authentification requise. L'API fournit uniquement le texte en anglais ; tout préfixe de langue dans le chemin est ignoré.

## Base URL

```
https://updates.foura.ai
```

## Statut des services

`GET /api/v1/status`

Renvoie le statut opérationnel en direct de chaque service FourA, ainsi que les incidents actifs et récents. Mis en cache côté serveur pendant 15 secondes, donc interroger plus fréquemment renvoie la même charge utile.

```bash
curl https://updates.foura.ai/api/v1/status
```

```json
{
  "overall": "operational",
  "updated_at": "2026-05-19T12:00:00.000Z",
  "services": [
    {
      "slug": "api-gateway",
      "name": "API Gateway",
      "description": "...",
      "status": "operational",
      "daily": [
        { "date": "2026-05-19", "status": "operational", "major_outage_minutes": 0, "partial_outage_minutes": 0, "degraded_minutes": 0, "internal_degraded_minutes": 0 }
      ]
    }
  ],
  "active_incidents": [],
  "recent_incidents": [
    { "id": 12, "service_slug": "api-gateway", "service_name": "API Gateway", "impact": "minor", "title": "API Gateway: Degraded Performance", "status": "resolved", "started_at": "...", "resolved_at": "...", "duration_seconds": 30 }
  ]
}
```

| Champ de premier niveau | Type | Description |
|-----------------|------|-------------|
| `overall` | string | `operational` si chaque service est fonctionnel, sinon l'une des valeurs d'état des services |
| `updated_at` | string | Date et heure de génération des données d'état, ISO 8601 avec suffixe `Z` |
| `services` | array | Une entrée par service surveillé avec `slug`, `name`, `description`, `status` actuel, et l'historique `daily` (jusqu'à 90 jours) |
| `active_incidents` | array | Incidents actuellement ouverts |
| `recent_incidents` | array | Incidents résolus des 14 derniers jours, chacun avec `id`, `service_slug`, `service_name`, `impact`, `title`, `status`, `started_at`, `resolved_at`, et `duration_seconds` |

Valeurs du champ `status` de service : `operational`, `degraded`, `partial_outage`, `major_outage`, `maintenance`. Une entrée `daily` peut également valoir `no_data`, pour un jour sans données enregistrées. `internal_degraded_minutes` comptabilise le temps sans impact client.

Valeurs du champ `impact` d'incident : `minor` (performances dégradées), `major` (interruption partielle), `critical` (interruption de service).

### Modèle de scrutation

Utilisez cet endpoint pour intégrer l'état de FourA à votre propre tableau de bord ou système de notification.

Lorsque les données d'état ne peuvent pas être récupérées, l'endpoint répond `502` avec `{"error": "Monitor unreachable"}`. Considérez cela comme un état inconnu plutôt qu'un échec, puis réessayez lors de la scrutation suivante.

```python
import requests

def check_foura():
    r = requests.get("https://updates.foura.ai/api/v1/status", timeout=5)
    r.raise_for_status()   # raises on the 502 "Monitor unreachable" answer: retry next poll
    data = r.json()
    if data["overall"] != "operational":
        # Page on-call, post to Slack, flip a feature flag, etc.
        for svc in data["services"]:
            if svc["status"] != "operational":
                print(f"{svc['name']}: {svc['status']}")
    return data
```

L'ancien `GET /api/status` renvoie `410 Gone` et redirige les appelants ici.

## Journal des modifications

`GET /api/changelog`

Renvoie les entrées publiées du journal des modifications par ordre chronologique inverse.

```bash
curl "https://updates.foura.ai/api/changelog?limit=20"
```

Paramètres de requête :

| Paramètre | Type | Valeur par défaut | Description |
|-----------|------|---------|-------------|
| `page` | integer | 1 | Numéro de page indexé à partir de 1 |
| `limit` | integer | 20 | Entrées par page (max 50) |
| `category` | string | - | Filtrer par `new`, `improved` ou `fixed` |

```json
{
  "entries": [
    {
      "id": 42,
      "title": "...",
      "body": "Markdown body",
      "category": "new",
      "tags": "[\"api\",\"dashboard\"]",
      "published": 1,
      "published_at": "2026-05-19T12:00:00Z",
      "created_at": "2026-05-19 11:42:08",
      "updated_at": "2026-05-19 11:44:31"
    }
  ],
  "total": 137,
  "page": 1,
  "limit": 20
}
```

| Champ | Type | Description |
|-------|------|-------------|
| `id` | integer | ID de l'entrée |
| `title` | string | Titre de l'entrée |
| `body` | string | Corps en Markdown |
| `category` | string | `new`, `improved` ou `fixed` |
| `tags` | string | Un tableau JSON **encodé sous forme de chaîne**. Parsez-le avant utilisation : `json.loads(entry["tags"])`. |
| `published` | integer | Toujours `1` ici. L'endpoint renvoie uniquement les entrées publiées. |
| `published_at` | string | ISO 8601 avec un suffixe `Z` |
| `created_at` | string | `YYYY-MM-DD HH:MM:SS`, UTC, sans indicateur de fuseau horaire |
| `updated_at` | string | Même format que `created_at` |

Les deux formats d'horodatage sont délibérément différents : `published_at` correspond à la date éditoriale et comporte un fuseau horaire, tandis que `created_at` et `updated_at` sont des horodatages de stockage. Tous deux sont en UTC. Un parseur qui suppose un format unique pour les trois générera une erreur sur les deux autres.

### RSS

Le changelog complet (les 30 entrées les plus récentes) est également publié sous forme de flux RSS à l'adresse suivante :

```
https://updates.foura.ai/rss
```

Abonnez-vous dans Feedly, Miniflux, Thunderbird ou tout autre lecteur. Le corps du flux correspond à celui du changelog, incluant le Markdown converti en HTML.

## Feuille de route

`GET /api/roadmap`

Renvoie tous les éléments publiés de la feuille de route, triés par nombre de votes puis par date de création.

```bash
curl https://updates.foura.ai/api/roadmap
```

```json
{
  "items": [
    {
      "id": 12,
      "title": "...",
      "description": "...",
      "status": "planned",
      "category": "developer-experience",
      "votes": 23,
      "target_date": "Q3 2026",
      "completed_at": null,
      "created_at": "2026-03-30 09:32:47"
    }
  ]
}
```

Valeurs pour `status` de l'élément : `planned`, `in_progress`, `done`, `cancelled`. Le tableau sur [updates.foura.ai/roadmap](https://updates.foura.ai/roadmap) affiche trois colonnes, donc un élément défini sur `cancelled` vous parvient via cet endpoint et n'apparaît jamais sur la page.

`category` est un slug en minuscules, et non le libellé affiché sur la page. Slugs actuellement utilisés : `api`, `infrastructure`, `developer-experience`, `dashboard`, `billing`, `analytics`, `authentication`. Considérez cette liste comme ouverte, car un nouvel élément peut en introduire un nouveau.

`target_date` est du texte libre (`"Q3 2026"`), pas une date. `completed_at` vaut `null` jusqu'à la publication d'un élément, puis passe au format ISO 8601 avec un suffixe `Z` (`2026-09-01T10:15:30.000Z`), soit le même format que le `published_at` d'une entrée de changelog. `created_at` utilise `YYYY-MM-DD HH:MM:SS` en UTC. Les deux formats diffèrent au sein d'un même objet, analysez donc chaque champ séparément.

### Vote

`POST /api/roadmap/:id/vote`

Bascule un vote sur un élément de la roadmap. Les votes sont anonymes et associés à l'IP de l'appelant ainsi qu'aux 50 premiers caractères de son User-Agent. Un nouvel appel supprime le vote. Un élément inconnu ou non publié renvoie `404 {"error": "Not found"}`.

```bash
curl -X POST https://updates.foura.ai/api/roadmap/12/vote
```

```json
{ "votes": 24, "voted": true }
```

`voted` indique l'état après l'appel : `true` si votre vote a été ajouté, `false` s'il a été retiré.

Les endpoints de la roadmap, `GET /api/roadmap` et celui-ci, sont limités à 30 requests par minute par IP source. Au-delà, la réponse est HTTP `429` avec `{"error": "Too many votes, slow down"}`. Chaque response de la roadmap contient `X-RateLimit-Limit`, `X-RateLimit-Remaining` et `X-RateLimit-Reset` (un timestamp Unix en secondes), afin que vous puissiez ralentir avant d'atteindre la limite.

## Problèmes connus

`GET /api/issues`

Renvoie les problèmes suivis par le support FourA.

```bash
curl "https://updates.foura.ai/api/issues?tab=open"
```

Paramètres de requête :

| Paramètre | Type | Valeur par défaut | Description |
|-----------|------|---------|-------------|
| `tab` | string | `open` | `open` pour les problèmes actifs, `resolved` pour les problèmes résolus/fermés |

```json
{
  "issues": [
    {
      "id": 5,
      "title": "...",
      "body": "Markdown description",
      "severity": "medium",
      "status": "investigating",
      "service_id": 3,
      "resolution": "",
      "opened_at": "2026-05-18T09:00:00Z",
      "resolved_at": null,
      "service_name": "API"
    }
  ]
}
```

| Champ | Type | Description |
|-------|------|-------------|
| `id` | integer | ID de l'incident |
| `title` | string | Résumé court |
| `body` | string | Description en Markdown |
| `severity` | string | `low`, `medium`, `high` ou `critical` |
| `status` | string | `open`, `investigating`, `resolved` ou `closed` |
| `service_id` | integer ou null | ID numérique du service concerné. `null` lorsque l'incident n'est lié à aucun service. |
| `service_name` | string ou null | Le nom d'affichage du service, résolu pour vous. Lisez cette valeur au lieu de mapper `service_id` vous-même. |
| `resolution` | string | La manière dont il a été résolu. Chaîne vide tant que l'incident est ouvert. |
| `opened_at` | string | ISO 8601 avec un suffixe `Z` |
| `resolved_at` | string ou null | ISO 8601 avec un suffixe `Z`, `null` tant qu'il est ouvert |

`service_id` est une clé étrangère numérique, pas le slug visible sur la page de statut. Associez les incidents aux services à l'aide de `service_name`.

Le payload de l'incident a une liste de colonnes fixe et ne comporte aucun horodatage de modification. Triez ou déterminez l'ancienneté d'un incident avec `opened_at` et `resolved_at`. Parmi les trois collections publiques, seules les entrées du changelog renvoient `updated_at`. Les éléments de la feuille de route renvoient également `created_at`, et les incidents ne renvoient ni l'un ni l'autre.

L'onglet `resolved` renvoie les 30 derniers incidents résolus et s'arrête là. L'onglet `open` les renvoie tous.

## Remarques

- Tous les endpoints sont publics et ne nécessitent aucune clé API. Les endpoints de la feuille de route sont limités à 30 requêtes par minute par IP source; les autres n'ont pas de rate limit propre actuellement, interrogez donc le statut sans dépasser ce que justifie son cache de 15 secondes.
- Les réponses sont en JSON sur HTTPS. La feuille de route et les incidents ne prennent aucun paramètre de pagination. La seule limite est `?tab=resolved` sur les incidents, qui renvoie 30 lignes.
- Pour les versions texte brut ou HTML brut du changelog, utilisez le flux [`/rss`](https://updates.foura.ai/rss) au lieu de `/api/changelog`.

## Liens connexes

- [Statut du service](https://foura.ai/docs/updates-portal/status): Consulter les mêmes données dans le navigateur
- [Changelog](https://foura.ai/docs/updates-portal/changelog): Parcourir les entrées avec filtres et pagination
- [Feuille de route](https://foura.ai/docs/updates-portal/roadmap): Voter pour des éléments dans l'UI
- [Incidents connus](https://foura.ai/docs/updates-portal/issues): Consulter les incidents ouverts et résolus
- [Portail des mises à jour](https://foura.ai/docs/updates-portal/overview): Vue d'ensemble de la section
