Plan des routes

Ce que sert le CDN, et à quelle adresse. Retour à l’accueil.

Routes

RouteRôle
/v/<version>/<fichier>L’artefact, immuable. C’est l’URL qu’un site de production épingle.
/latest/<fichier>L’artefact de la dernière version. Bouge à chaque publication : maquettes et recette seulement.
/api/versionsToutes les versions publiées et l’alias latest (JSON).
/api/latestL’alias latest seul : version, date, auteur (JSON).
/api/v/<version>Le manifeste d’une version : liste des fichiers, tailles, SHA-256 (JSON). Pas les fichiers eux-mêmes : ils sont sous /v/<version>/<fichier>.
/healthSonde de vivacité du superviseur.

/v/… ou /api/v/… ?

Je veux…URL
charger la feuille dans un site/v/2.3.0/ragt-tokens.min.css
savoir quels fichiers contient la 2.3.0/api/v/2.3.0
connaître la dernière version/api/latest
lister toutes les versions/api/versions

/v/ sert des fichiers ; /api/ sert du JSON qui les décrit. /api/v/2.3.0/ragt-tokens.min.css n’existe pas.

Production ou recette ?

Un site en production épingle une version. Ces octets ne changeront jamais, et le navigateur les garde un an sans redemander :

<link rel="stylesheet" href="https://designsystem-cdn.ragt.com/v/2.3.0/ragt-tokens.min.css">

Une maquette ou une recette peut suivre la dernière version, et accepte de changer sans prévenir (cache de 5 minutes) :

<link rel="stylesheet" href="https://designsystem-cdn.ragt.com/latest/ragt-tokens.min.css">