API docs by Redocly

Helia NC — État du réseau (0.1.0)

Download OpenAPI specification:

URL: https://www.opt.nc/ License: MIT

Helia NC — Maintenances programmées

API de consultation en temps réel des maintenances programmées sur le réseau télécoms Helia by OPT-NC en Nouvelle-Calédonie.

Source des données

Les données sont scrapées à la volée depuis helia.nc/etat-du-reseau. Aucun cache côté API — chaque appel reflète l'état courant de la page.

Identifiants stables

Chaque maintenance possède un id SHA256 (8 hex) calculé sur ses champs métier. Cet identifiant est stable entre deux scrapes si la maintenance n'a pas changé, ce qui permet :

  • la clé de message Kafka (partitionnement déterministe)
  • l'upsert idempotent dans OpenSearch (_id)

Communes officielles

Les communes sont normalisées selon le référentiel officiel communes-nc-limites-terrestres-simplifiees de data.gouv.nc. Jointure directe possible sur le champ nom.

Timezone

Tous les timestamps de maintenance sont en heure locale NC (UTC+11), sans changement d'heure. Le champ scraped_at est en UTC.

maintenances

Consultation des maintenances programmées sur le réseau Helia NC. Les données sont scrapées en temps réel depuis helia.nc.

Liste toutes les maintenances programmées

Scrape en temps réel la page helia.nc/etat-du-reseau et retourne la liste complète des maintenances programmées, validées et normalisées.

  • Communes normalisées selon le référentiel officiel NC
  • Timestamps en heure locale NC (UTC+11)
  • Services et impact sous forme d'enums
  • id stable entre deux scrapes (SHA256)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Récupère une maintenance par son identifiant SHA256

Retourne la maintenance dont l'id correspond aux 8 caractères hexadécimaux fournis.

L'id est un SHA256 tronqué calculé sur les champs métier de la maintenance. Il est stable tant que la maintenance n'est pas modifiée sur la source.

path Parameters
id
required
string (Id) ^[0-9a-f]{8}$
Examples: a6cec665

Identifiant SHA256 de la maintenance (8 caractères hexadécimaux minuscules).

Responses

Response samples

Content type
application/json
{
  • "communes_concernees": [
    ],
  • "duree_coupure_max_minutes": 30,
  • "duree_coupure_min_minutes": 20,
  • "duree_fenetre_minutes": 360,
  • "id": "a6cec665",
  • "impact": "COUPURE_20_30_MIN",
  • "scraped_at": "2026-06-01T10:00:00Z",
  • "services": [
    ],
  • "source_url": "https://helia.nc/etat-du-reseau",
  • "timestamp_debut": "2026-06-01T23:00:00+11:00",
  • "timestamp_fin": "2026-06-02T05:00:00+11:00"
}