Documentation
How PostShip checks your site, connects to your tools, and only alerts when something breaks. Each page says what the feature does, how to set it up, what triggers an alert, and what your plan allows.
Pages marked FR are still in French; the English versions are on their way.
Create a projectYour first URL checked in five minutes.Connect your hostEvery deploy checked to the second.Get alertedEmail, Discord, Slack, Telegram — and when to stay quiet.From your CIOne request, one Ship Score, one exit code.
Getting started
3What PostShip does, and your first project in five minutes.
- IntroductionFRCe que PostShip fait, en une phrase, et comment tout s'articule — déploiements, vérifications, alertes, page de statut.
- Premier projetFRCréer un projet, ajouter une URL, et voir le premier résultat en quelques secondes.
- VocabulaireFRLes dix mots que l'application emploie partout, et ce qu'ils désignent exactement.
Checks
19What PostShip looks at on your pages, on every pass and every deploy.
- HTTP et assetsFRLa vérification par défaut — la page répond, avec le bon statut, dans le délai, et ses fichiers JS et CSS existent encore.
- Contenu attenduFRExiger qu'un texte soit sur la page, ou qu'il n'y soit pas — comparé comme un lecteur le ferait.
- Seuil de latenceFRTransformer un temps de réponse trop long en échec, donc en alerte, donc en incident.
- Les pages qui font vendreFRSurveiller d'un coup les pages qui font perdre de l'argent quand elles cassent — accueil, tarifs, connexion, checkout.
- Parcours d'argentFRLa chaîne qui mène au paiement, vérifiée dans l'ordre, arrêtée à la première étape cassée.
- Formulaire canaryFRVérifier que l'endpoint de votre formulaire de contact accepte encore un envoi, sans polluer votre CRM.
- Open GraphFRVérifier que la carte sociale d'une page reste montrable — titre, description, image qui se charge.
- Sitemap et SSLFRLe sitemap est lu et ses pages sondées ; le certificat est suivi jusqu'à son expiration, palier par palier.
- Vérification StripeFRVérifier que la page où Stripe renvoie vos clients après paiement répond encore.
- Contrat d'APIFRPostShip apprend la forme d'une réponse JSON sur trois passages, puis alerte dès qu'elle dérive.
- Tâche planifiée (battement)FRSurveiller ce qui tourne sans page — un cron, un worker, une sauvegarde — par l'absence d'appel.
- Contrôles du siteFRLes treize vérifications que PostShip pose lui-même sur votre domaine, hors quota, et qui ne tournent qu'au déploiement.
- IndexabilitéFRGoogle peut-il encore explorer et indexer le site après ce déploiement ?
- Visibilité IAFRLes moteurs de réponse — ChatGPT, Claude, Perplexity, les AI Overviews de Google — peuvent-ils encore lire et citer votre site ?
- Email (DNS)FRLe domaine du site peut-il envoyer des emails qui arrivent ? MX, SPF, DMARC et DKIM, lus dans le DNS.
- AccessibilitéFRLa page d'accueil est-elle utilisable sans les yeux ? Langue, textes alternatifs, libellés, liens — lus dans le HTML servi.
- Balises SEOFRTitre, meta description, canonical, viewport et hreflang de la page d'accueil, tels qu'un moteur les lit.
- Poids de pageFRCombien pèse la page d'accueil pour un visiteur — le HTML et les ressources qu'il référence, additionnés à chaque déploiement.
- RedirectionsFRLes trois adresses que les gens tapent — http, www., sans www. — mènent-elles au site en https ?
Deployments
19Checking at deploy time: webhooks, hosts, GitHub, Ship Score.
- Connecter votre hébergeurFRDéclencher une vérification complète dans la seconde qui suit chaque mise en ligne, et ce que ce passage produit en plus.
- Connecter VercelFRVérifier le site dès que Vercel a fini de déployer, en un clic ou avec un webhook collé à la main.
- Connecter NetlifyFRVérifier le site dès que Netlify a fini de déployer, avec une notification créée pour vous ou un webhook signé à la main.
- Connecter Cloudflare PagesFRVérifier le site dès que Cloudflare Pages a fini de déployer, avec la destination et la notification créées pour vous ou à la main.
- Webhook génériqueFRPrévenir PostShip depuis n'importe quel hébergeur ou pipeline de CI avec une adresse, un secret et une ligne de curl.
- Détection sans webhookFRComment PostShip reconnaît un déploiement en lisant l'empreinte de build de votre page d'accueil, sans rien brancher.
- Connecter GitHubFRPublier le résultat de chaque déploiement vérifié sur le commit, sous la forme d'un Check Run nommé PostShip.
- Bloquer un merge sur PostShipFRFaire du Check PostShip une condition de fusion, choisir ce qui le fait rougir, et poser un score plancher.
- T+2 / T+8FRLes deux re-vérifications automatiques programmées deux et huit minutes après chaque déploiement de production, et pourquoi elles existent.
- La prod sert bien ce déploiementFRAprès chaque déploiement, PostShip vérifie que votre domaine sert la nouvelle version, et pas celle d'avant restée dans un cache.
- Ship ScoreFRLa note sur 100 de chaque déploiement de production, catégorie par catégorie, et ce qu'elle devient.
- Diff du déploiementFRCe que ce déploiement a changé sur chaque page surveillée, comparé au déploiement précédent, et le résumé à coller dans un ticket.
- Archive du déploiementFRL'image de partage de chaque déploiement, gardée pour montrer l'avant une fois que l'URL d'origine a disparu.
- Ce qui a changéFRÊtre prévenu quand un titre, un H1, une description ou un og:title disparaît ou devient « coming soon » juste après un déploiement.
- PreviewsFRVérifier chaque déploiement de preview sur sa propre adresse, avant qu'il parte en production, et décider séparément d'en être alerté.
- Budget de performanceFRMesurer trois pages avec PageSpeed Insights après chaque déploiement, et faire perdre des points au déploiement qui ralentit le site.
- Régression visuelleFRComparer pixel à pixel la capture de chaque page mesurée avec celle du déploiement précédent, et alerter au-delà du seuil que vous choisissez.
- Gel de déploiementFRDéclarer les moments où votre équipe s'interdit de déployer, et savoir quand quelqu'un le fait quand même.
- Retour arrièreFRRemettre en production le dernier déploiement vérifié bon — à la main depuis Déploiements, ou tout seul quand une page argent casse à la mise en ligne.
Alerts & incidents
14Where and when PostShip warns you, and how it keeps quiet when it should.
- Email, Discord, Slack, TelegramFRQui reçoit quoi, par quel canal, et pourquoi une alerte ne part parfois pas.
- Notifications sur le téléphoneFRRecevoir les alertes en notification sur votre téléphone ou votre navigateur, sans Slack ni email entre la panne et vous.
- Connecter DiscordFRRecevoir les alertes dans un salon Discord, et interroger le projet avec /postship.
- Connecter SlackFRRecevoir les alertes dans un canal Slack, et interroger le projet avec /postship.
- Connecter TelegramFRRecevoir les alertes dans une conversation Telegram, et interroger le projet avec /status ou /check.
- RèglesFRConfirmation avant alerte, heures calmes, coupure du projet et silence d'une URL.
- MaintenanceFRUne fenêtre ponctuelle ou une règle hebdomadaire pendant laquelle rien n'alerte, annoncée sur la page de statut.
- Webhook sortantFRRecevoir chaque alerte en JSON signé HMAC sur votre propre endpoint, et choisir les événements.
- IncidentsFRComment un incident s'ouvre et se ferme tout seul, ce que la page Incidents montre, et comment le publier.
- Cause probableFRComment PostShip met les signaux côte à côte autour d'une panne et en tire des hypothèses classées.
- AcquittementFR« Je m'en occupe » : dire à l'équipe que quelqu'un est déjà sur l'incident, et rendre la main.
- EscaladeFRUn incident que personne n'a pris en charge au bout de N minutes est renvoyé à toute l'équipe, une fois.
- Résumé quotidienFRUn message chaque matin à 8 h sur vos salons : taux de la nuit, incidents ouverts, déploiements de la veille.
- FournisseursFRLes douze pages de statut que PostShip suit, comment il devine celles qui vous concernent, et ce que ça change dans l'alerte.
Performance & visitors
3Response time, what your visitors measure, and what's out of the ordinary.
- PerformanceFRLe temps de réponse de chaque page dans le temps, l'avant/après déploiement, et la bande « normal ».
- Anomalies de latenceFRUne alerte quand une page devient anormalement lente pour cette heure de la semaine, avec la formule exacte.
- Vu depuis cinq continentsFRVos pages sondées depuis l'Europe, l'Amérique du Nord, l'Amérique du Sud, l'Asie et l'Océanie, et l'alerte quand deux régions ne les voient plus.
Security & integrity
7What must stay closed, what must stay the same, and what must stay yours.
- Scripts tiersFRComment PostShip relève l'empreinte de chaque script chargé depuis un autre domaine, et vous prévient quand il change chez son hébergeur.
- En-têtes de sécuritéFRLes en-têtes que PostShip attend sur votre page d'accueil, le contenu mixte, et ce qui fait échouer le contrôle.
- Cookies et consentementFRLes cookies que votre serveur pose sur un premier visiteur, avant tout bandeau, et ce que PostShip en dit.
- Fichiers exposésFRLes chemins que PostShip sonde à la racine de votre site (.env, .git, sauvegardes, phpinfo) et comment il évite le faux positif de la SPA.
- FuitesFRCe que votre page d'accueil laisse voir qu'elle ne devrait pas — lorem ipsum, localhost, adresse de préproduction, clé secrète — et comment PostShip le lit.
- Certificats émisFRLes certificats qui existent pour votre domaine, lus dans les journaux de transparence, et ce qui alerte quand un émetteur inattendu en signe un.
- Domaine et DNSFRLa dérive DNS relevée à chaque déploiement, l'expiration du domaine lue par RDAP, et la frise de la page Santé qui raconte ce qui a bougé.
Public pages
9What your clients see: status page, badge, ship cards, reports.
- Page de statutFRL'adresse publique que vos clients ouvrent quand ça ne répond plus : composants, disponibilité, incidents publiés, abonnés, RSS, bandeau.
- Votre domaine sur la page de statutFRPublier la page de statut sur status.votre-domaine.fr : le TXT de preuve, le CNAME, les trois états, et la couleur d'accent.
- Calendrier de maintenanceFRLes fenêtres de maintenance annoncées sur la page de statut, sur trente jours, et le flux .ics que vos clients glissent dans leur agenda.
- Badge et partageFRLe badge SVG pass/fail à coller dans un README, la page Partage, et les liens de lecture pour un client.
- Carte de déploiementFRLa page publique non listée qui répond « est-ce que le site va bien ? » avec le score du dernier déploiement, sans ouvrir le tableau de bord.
- Rapport partageableFRLa page non listée que vous envoyez à un client qui demande « alors, ce mois-ci ? » : disponibilité, incidents, déploiements, budget d'erreur, contrôles du site.
- Rapport mensuel à vos clientsFRLe 1er du mois, le bilan du mois écoulé part par email aux adresses de votre choix — pour les agences qui rendent des comptes à leurs propres clients.
- Post-mortemFRLe post-mortem d'un incident en Markdown, prêt à coller, et le lien non listé pour le partager avec un client puis le retirer.
- Scan publicFRCe que la vérification gratuite de la page d'accueil de postship.fr regarde sur une URL, comment elle la note, et ses limites anti-abus.
Automation
6API, CI, MCP, exports: PostShip from your tools.
- APIFRVue d'ensemble de l'API v1 : le jeton Bearer, les quatre routes, les quotas par plan, les codes d'erreur et le format des réponses.
- POST /api/v1/checkFRLa référence complète de la vérification à la demande : le corps, chaque champ de la réponse, les codes HTTP, et des exemples curl, JavaScript et GitHub Actions.
- GET /api/v1/projectsFRLa référence des trois routes de lecture : vos projets, les incidents ouverts d'un projet, et son dernier déploiement de production.
- Vérifier depuis votre CIFRVérifier une URL avant de fusionner ou après un build, avec un appel HTTP depuis GitHub Actions ou GitLab CI, et faire échouer l'étape sur le verdict ou le score.
- Serveur MCPFRDonner à un agent dans Cursor ou Claude Code l'état de vos projets et le verdict du dernier déploiement, sans lui donner les clés.
- ExportsFRLes fichiers que vous pouvez télécharger depuis un projet — incidents, journal et performance en CSV, dernier déploiement en JSON — et le format exact de chacun.
Account & plans
6Plans, billing, team, data.
- Plans Free / Pro / Team / AgenceFRLe tableau complet de ce que chaque plan permet, limite par limite — projets, URL, cadence, collaborateurs, hébergeur, sondes.
- FacturationFRL'essai, le changement de plan, l'annulation, l'adresse de facturation et les factures — tout ce qui touche à votre abonnement Stripe.
- ÉquipeFRInviter des collaborateurs sur un projet, ce que chaque rôle peut faire, et ce qui reste au propriétaire.
- ProjetsFRCréer un projet, ce que l'URL de base impose aux URL surveillées, la pause, les étiquettes, la suppression et les quotas.
- Sécurité du compteFRComment on se connecte à PostShip, la double authentification, les comptes liés, le changement d'adresse et ce qu'une session protège.
- Données & rétentionFRCombien de temps PostShip garde chaque donnée, comment l'exporter, ce que le beacon RUM conserve de vos visiteurs, et comment supprimer un compte.