Flux PolirisRéférence d'intégration
Sommaire de la documentation

Dépôt SFTP

Connexion, arborescence, dépôt atomique, cadence de lecture et archivage.

Connexion

Protocole
SFTP (sous-système SSH-2). FTP et FTPS ne sont pas servis.
Port
22
Identifiant
poliris-<slug>, un par éditeur, partagé par toutes ses agences
Authentification
Mot de passe, transmis en privé
Clé d'hôte
ed25519. Empreinte SHA256:… transmise avec les accès : épinglez-la, n'acceptez pas une autre clé
Shell
Aucun : connexion SFTP seule, sans redirection de port

Arborescence et droits

Le compte est enfermé dans son dossier. Il voit trois répertoires :

CheminDroits du compteContenu
/incominglecture, écritureZips à traiter
/processedaucunZips traités, rangés par jour
/rejectedaucunZips refusés, rangés par jour

Toute écriture hors de /incoming répond Permission denied. Le site déplace les fichiers lui-même ; il ne modifie ni leurs droits, ni leur contenu.

Dépôt atomique

Seuls les fichiers dont le nom se termine par .zip (casse ignorée) sont lus, et seulement si leur date de modification a plus de 2 minutes. Pour qu'un zip ne soit jamais lu à moitié, envoyez-le sous un nom temporaire puis renommez-le :

Session sftp
sftp> put export-20260929-1200.zip /incoming/export-20260929-1200.zip.part
sftp> rename /incoming/export-20260929-1200.zip.part /incoming/export-20260929-1200.zip
  • Nom de fichier libre. Préférez un nom unique par envoi (horodatage) : un nom réutilisé écrase le fichier précédent s'il n'a pas encore été lu.
  • Plusieurs zips peuvent attendre ensemble : ils sont traités du plus ancien au plus récent.
  • Un zip peut porter une ou plusieurs agences : chaque ligne est rattachée par sa colonne 1.

Cadence de lecture

  • Le site passe toutes les 15 minutes. Un envoi plus fréquent n'accélère rien.
  • Un passage travaille au plus 240 secondes. Un gros premier envoi (téléchargement et dépôt de toutes les photos) peut s'étaler sur plusieurs passages : le zip reste alors dans /incoming jusqu'à la fin de son traitement.
  • Deux passages ne se chevauchent jamais.

Note

Pendant la reprise d'un gros zip, ne le remplacez pas par un envoi plus récent sous le même nom : donnez un nouveau nom, il sera traité à la suite.

Archivage

  • Traité : /processed/AAAA-MM-JJ/<nom>, date du jour en heure de Paris.
  • Refusé : /rejected/AAAA-MM-JJ/<nom> (motifs dans Rejets et avertissements).
  • Nom déjà présent le même jour : préfixé par l'horodatage en millisecondes, 1759140000000-<nom>.
  • Conservation 90 jours, puis purge automatique. Le site ne supprime jamais un fichier.
PrécédentVue d'ensembleSuivant Format du fichier

Dernière mise à jour : 29 septembre 2026