Badge et partage

Un badge SVG par projet, opt-in — pass/fail uniquement, sans historique, sans liste d'URL, sans journal d'incidents. Il répond « introuvable » tant que vous ne l'avez pas explicitement activé depuis la page Partage. Ce n'est pas une page de statut : pour ça, il y a la page de statut.

Ce que PostShip fait

Le badge vit à postship.fr/badge/<identifiant-du-projet>. Une image de 140 × 20 pixels, dans le style de shields.io : « PostShip » à gauche, l'état à droite, deux aplats de couleur et rien d'autre — pas de reflet, pas de dégradé, un bit d'information.

Pendant une fenêtre de maintenance annoncée, le badge dit « maintenance » plutôt que « passing » : un lecteur mérite de savoir que les vérifications ne sont pas le sujet en ce moment, et « up » serait une affirmation que personne ne garantit.

L'image est servie avec un cache d'une minute. Elle ne porte aucune URL, aucun détail de vérification, aucune donnée personnelle : seul l'état résumé du projet sort.

Régler

Projet → Partage → Badge public → Activer le badge. La page affiche alors le badge lui-même et le Markdown à copier : une image Markdown dont la source est https://postship.fr/badge/<identifiant-du-projet>, entourée d'un lien vers https://postship.fr. Copiez-le depuis la page plutôt que de reconstruire l'adresse. En HTML, la même image dans une balise img avec un lien autour :

<!-- Dans un README HTML, une page d'aide, un pied de page -->
  <a href="https://postship.fr"><img src="https://postship.fr/badge/<identifiant-du-projet>" alt="PostShip" width="140" height="20"></a>

Désactiver fait répondre 404 à l'adresse, immédiatement (au cache près) : un README qui l'affiche encore montre une image cassée, pas un état périmé.

Le reste de la page Partage

La page Partage réunit ce que vos visiteurs et vos clients voient de ce projet, sans accès à votre tableau de bord :

• Cartes sociales : l'aperçu réel de chaque page qui a une vérification Open Graph — titre, description, image, tels que les réseaux les afficheront.
• Badge public : cette page.
• Carte de ship : une page publique non listée avec le score du dernier déploiement — voir Carte de ship.
• Liens de lecture pour un client : un lien psl_… qui ouvre le projet en lecture seule. Une agence qui surveille le site de son client veut le lui montrer sans lui donner un compte collaborateur — qui verrait les jetons d'API, la facturation, les autres projets. Le jeton n'est pas conservé, seule son empreinte l'est : un lien perdu se révoque, il ne se retrouve pas. Il périme au bout de quatre-vingt-dix jours, parce qu'un lien de lecture qui ne périme jamais finit par circuler — dans un fil de discussion, dans un ticket, chez le prestataire suivant. Un lien inconnu, révoqué ou périmé répond exactement la même chose.

Ce qui déclenche une alerte

Rien : le badge et les liens reflètent l'état, ils ne l'évaluent pas. Ce qui change la couleur, ce sont vos vérifications (HTTP et assets, pack argent, etc.).

Limites et plans

Voir les plans.

Dépannage

Pourquoi le badge affiche-t-il « pending » alors que mes vérifications tournent ?

Le badge lit l'état résumé du projet, écrit à la fin de chaque passage. Sur un projet tout neuf, le premier passage n'est peut-être pas fini : la première vérification part à l'ajout de l'URL, et le cycle suit toutes les cinq à trente minutes selon le plan.

Pourquoi le badge reste-t-il vert alors qu'une URL est en échec ?

Une minute de cache. L'état du projet est recalculé après chaque passage — et après chaque « Lancer maintenant » — sur le dernier verdict de toutes les cibles actives : une seule en fail ou en error suffit à le mettre en rouge. Si le badge reste vert, la cible en cause est désactivée, ou son verdict n'a pas encore été écrit.

Pourquoi mon README affiche-t-il une image cassée ?

Le badge est désactivé (404), ou l'identifiant du projet a été mal copié. Copiez le Markdown depuis la page Partage plutôt que de reconstruire l'adresse.