SFTP et contrat d'interface
Pour déposer des fichiers, seul le protocole SFTP est accepté (pas de FTP), et chaque échange est formalisé par un contrat d'interface en neuf éléments. Notre équipe met en place la connexion avec la vôtre, sans configuration en libre-service.
Ce que le code supporte
Mode | Ce qui est supporté | Remarque |
|---|---|---|
SFTP | Dépôt de fichiers ; authentification par identifiant et mot de passe | Seul protocole de fichiers accepté, pas de FTP |
Amazon S3 | Copie depuis votre bucket ; accès par clés AWS | Une des quatre voies d'arrivée |
BigQuery | Transfert ou partage | |
Connecteur SaaS | Selon l'outil |
Les transferts SFTP sont incrémentaux : un fichier déjà copié et non modifié n'est pas recopié, et chaque fichier est retenté jusqu'à trois fois en cas d'échec.
Schéma (version texte)
Votre système (export planifié) → Dossier convenu au contrat (dépôt SFTP)
Dossier convenu au contrat → Ingestion Actionable (espace brut) (copie incrémentale, 3 tentatives par fichier)
Ingestion Actionable (espace brut) → Modèles communs
Pourquoi un contrat d'interface
Un fichier n'impose pas de format comme le fait une API : une colonne renommée ou un ordre modifié peut fausser les analyses sans erreur visible. Le contrat d'interface est le garde-fou commun, requis dès qu'on échange par fichier plat.
Les neuf éléments à préciser
Chaque échange par fichier est formalisé par un contrat qui précise :
le sens du flux : de vous vers nous, ou l'inverse ;
le protocole : SFTP, bucket ou BigQuery ;
la fréquence et l'heure de dépôt, avec le fuseau ;
le chemin : dossier de dépôt ;
le nom de fichier : motif de nommage, date incluse ;
le format et l'encodage : par exemple CSV en UTF-8, séparateur, dates au format ISO 8601 ;
le schéma de colonnes figé : colonnes, ordre, types ;
la logique complète ou incrémentale : tout l'historique ou seulement les nouveautés ;
la rétention et la purge : qui supprime les fichiers déposés, et quand.
Le schéma de colonnes est figé : aucun ajout, suppression ni changement d'ordre sans revalidation des deux côtés. Le mode complet ou incrémental se précise dès le premier échange, et toute évolution du contrat repasse par une validation explicite avant la mise en production.
Exemple fictif de contrat
Valeurs d'illustration, à adapter à votre cas.
Élément | Exemple fictif |
|---|---|
Sens du flux | De vous vers nous |
Protocole | SFTP |
Fréquence et heure | Tous les jours à 08:30, fuseau Europe/Paris |
Chemin |
|
Nom de fichier |
|
Format et encodage | CSV, UTF-8, séparateur |
Schéma de colonnes | Identifiant client, date de l'événement, canal, type d'événement |
Complet ou incrémental | Incrémental après un dépôt initial de l'historique |
Rétention et purge | À convenir des deux côtés |
Sécurité des échanges
Sécurité, certifications, sous-traitants et chiffrement : les informations de référence sont publiées sur notre Trust Center, https://trust.actionable.live.