API Updates Portal

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.

curl https://updates.foura.ai/api/v1/status
{
  "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.

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.

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
{
  "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.

curl https://updates.foura.ai/api/roadmap
{
  "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 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"}.

curl -X POST https://updates.foura.ai/api/roadmap/12/vote
{ "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.

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
{
  "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 au lieu de /api/changelog.
Mis à jour : 5 novembre 2026