Plan des routes
Ce que sert le CDN, et à quelle adresse. Retour à l’accueil.
Routes
| Route | Rô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/versions | Toutes les versions publiées et l’alias latest (JSON). |
/api/latest | L’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>. |
/health | Sonde 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">