Exports

Un client demande, en fin de trimestre, ce qui s'est passé ; un prestataire conteste que « c'est plus lent depuis la refonte » ; un rapport a besoin d'une pièce jointe. La réponse ne doit pas être une capture d'écran d'un tableau de bord. Chaque page du projet qui porte une histoire a son export : un fichier, dans un format qu'un tableur ou un script lit sans surprise.

Ce que PostShip exporte

Les exports sont des liens directs vers /api/projects/<id>/export/… : ils passent par la même autorisation que la page (un projet qu'on n'a pas le droit de voir répond « introuvable ») et exigent le second facteur quand le compte l'a activé — le fichier sort du document qu'on joint à un rapport client, il mérite la même porte que le tableau de bord.

Les incidents (CSV)

Une ligne par incident sur la fenêtre conservée, du plus récent au plus ancien : debut, fin (vide si en cours), etat (investigating, identified, resolved), publie (oui / non), resume. Ce sont les incidents du projet, publiés ou non — pas seulement ceux racontés sur la page de statut. La fenêtre est celle du plan, pas quatre-vingt-dix jours pour tout le monde : exporter au-delà de ce qu'il conserve rendrait un fichier vide sur sa fin, ce qui se lit comme « aucun incident » plutôt que « pas de données ».

Le journal (CSV)

Ce que la page Journal montre, sans le plafond d'affichage : date, genre, titre, detail, acteur. Les genres : deploiement, incident, alerte, equipe, note — jusqu'à 500 événements par source, 2 500 au total. Le domaine (DNS, certificats) n'y est pas : ses événements se calculent par comparaison de relevés, et l'export doit rester ce que la base contient, pas ce qu'on en déduit.

La performance (CSV)

Une ligne par URL de type http, form ou journey, classée de la plus lente à la plus rapide : url, type, mesures (le nombre de passages), mediane_ms, p95_ms, max_ms, depuis, jusqua. Le temps mesuré est celui de la page Performance, sur la fenêtre du plan.

Le dernier ship (JSON)

La pièce qu'on joint à un rapport : le score, ce qui a été vérifié, ce qui a échoué. De production, jamais une preview — un document qui prétend décrire ce qui est en ligne ne doit pas décrire une branche.

{
  "projet": "Boutique",
  "adresse": "https://boutique.fr",
  "deploiement": {
    "hebergeur": "vercel",
    "commit": "a1b2c3d",
    "date": "2026-09-11T08:39:51.000Z",
    "verdict": "pass",
    "verificationsEnEchec": 0,
    "score": 100,
    "raison": null
  },
  "urls": [{ "url": "https://boutique.fr/", "verdict": "pass" }],
  "exporteLe": "2026-09-11T09:00:00.000Z"
}

Un projet sans déploiement de production suivi reçoit quand même un document — deploiement: null et un message qui le dit — plutôt qu'un 404 : le navigateur n'affiche pas le corps d'une erreur sur un lien de fichier, et le téléchargement échouerait sans rien dire.

Le format CSV

Fait pour qu'Excel, Numbers, LibreOffice ou pandas le lisent sans réglage :

• UTF-8 avec BOM : sans lui, Excel lit un fichier UTF-8 en latin-1 et affiche « résolu ». Le fichier serait juste, le tableur le lirait mal, et c'est nous qu'on accuserait.
• Lignes en CRLF, comme la norme l'attend.
• Chaque cellule entre guillemets, guillemets internes doublés : un résumé d'incident contient des virgules, des guillemets et des sauts de ligne, et c'est le guillemet non doublé qui casse un fichier au milieu d'une phrase.
• Dates en ISO 8601 (UTC), durées en millisecondes.
• Nom de fichier : postship-incidents-2026-09-11.csv, postship-journal-…, postship-performance-…, postship-ship-2026-09-11.json.
• Cache-Control: no-store : chaque téléchargement est frais.

Ce qui déclenche une alerte

Rien : les exports lisent. Ce qu'ils contiennent vient des incidents, des alertes, des déploiements et des passages.

Limites et plans

La fenêtre est celle de la rétention. Le journal exporte tout ce qui est encore en base. Voir les plans.

Dépannage

Pourquoi le téléchargement répond-il « Double authentification requise » ?

Votre compte a un second facteur et cette session ne l'a pas encore validé. Reconnectez-vous en validant le second facteur, puis relancez le téléchargement.

Pourquoi Excel affiche-t-il tout dans une seule colonne ?

Certaines versions localisées d'Excel attendent un point-virgule. Utilisez « Données → À partir d'un fichier texte/CSV » et choisissez la virgule comme séparateur ; le fichier lui-même est standard.

Pourquoi l'export des incidents est-il vide alors que le journal en montre ?

Le journal exporte tout ce qui est en base ; l'export des incidents se limite à la fenêtre du plan. Un incident plus ancien que la fenêtre peut encore figurer dans le journal, plus dans l'export des incidents.