Aller au contenu

Cudatus Relay

Le réseau, et les outils autour

Relay est un réseau d’événements routiers en temps réel : un contrat pour publier, un flux pour consommer, et chaque acteur connecté enrichit le même réseau.

composants

De quoi Relay est fait

Quatre composants et un seul contrat entre eux. Chaque ligne renvoie à ce qui tourne réellement.

  • API

    REST pour les écritures et les lectures par zone, server-sent events pour le flux temps réel. Authentifiée par une clé d’organisation ; le navigateur reçoit à la place un ticket court en lecture seule. C’est le produit — tout le reste de cette liste existe pour le rendre plus facile à atteindre.

    Lire la documentation

  • Explorer

    Une vue en plan de chaque événement actif dans un disque d’abonnement, alimentée par le flux même auquel un client s’abonne. Elle a sa propre page, et sert aussi d’outil de diagnostic quand un abonné demande pourquoi il n’a pas reçu quelque chose.

    Ouvrir l’Explorer

  • Sandbox

    Publiez des événements de test et validez une intégration avant de la brancher sur la production. Chaque clé est émise en live ou en sandbox, l’usage est compté par environnement, et l’isolation est à sens unique par conception : les consommateurs live ne voient jamais les événements sandbox, et une clé sandbox lit les données live sans jamais pouvoir y écrire. Comme elle lit les données live, une sandbox n’est jamais vide ; le trafic que vous maîtrisez est celui que vous publiez vous-même, et la documentation fournit un script pour cela.

    Lire le guide sandbox

  • Console

    Le portail développeur. Connexion par code envoyé par e-mail (sans mot de passe, délibérément), création d’une organisation, invitation de collègues, émission et révocation de vos clés d’API vous-même — l’émission est un acte de propriétaire protégé par une vérification TOTP, la clé en clair n’est affichée qu’une fois, et chaque autre propriétaire est prévenu par e-mail dans les secondes qui suivent. Elle montre aussi l’usage jour par jour, les offres, et un journal d’audit en ajout seul de qui a fait quoi.

    Ouvrir la Console

ce qui ne change pas

Trois garanties que donne le contrat

Relay est une infrastructure : les décisions coûteuses ont donc été prises dès le premier jour plutôt que rattrapées après coup. Ce sont celles qu’un intégrateur est en droit de nous opposer.

  • Le contrat ne casse pas

    Enveloppe versionnée, champs uniquement ajoutés, champs et valeurs inconnus ignorés par les clients. Un changement de sens est une nouvelle version d’URL servie à côté de l’ancienne, pas une nouvelle enveloppe.

  • Les événements expirent, et c’est le produit

    Chaque événement porte une durée de vie issue de son type. Relay détient ce qui est vrai maintenant ; la copie analytique détient l’historique. Rien n’annonce une expiration naturelle — l’échéance est déjà entre vos mains.

  • Aucune trajectoire, jamais

    Relay reçoit des événements ponctuels, jamais des traces. Le contrat ne contient aucune identité de véhicule, il n’y a donc rien à pseudonymiser. L’organisation émettrice n’apparaît pas du tout sur le réseau — nous pouvons attribuer un événement en interne, personne sur le réseau ne le peut.

ce qui y circule

Le réseau transporte de vrais événements sur de vraies routes

Relay ingère le flux du réseau routier national français, publié en DATEX II sous Licence Ouverte 2.0 : votre première requête renvoie donc ce qui se passe sur la route à cet instant — et chaque organisation qui se connecte alimente le même réseau.

Deux sources, un seul contrat

Chaque incident publié par le gestionnaire routier national est sur Relay en un cycle de collecte, avec sa licence et l’heure de sa dernière révision à la source. Les événements publiés par les organisations connectées arrivent sur le même réseau, dans la même enveloppe, et un consommateur les distingue par source_kind plutôt qu’en intégrant deux fois.

Couverture

La France aujourd’hui : le flux du réseau national, plus tout ce que publient les participants. Les autoroutes concédées et d’autres flux européens sont ajoutés opérateur par opérateur — chacun est un connecteur contre le même contrat, jamais une modification de celui-ci. Ce qui circule en ce moment.