API ou import CSV : quel choix pour votre flux de données ?

Partir du besoin de mise à jour

Un catalogue actualisé ponctuellement et le statut d’une demande client n’ont pas les mêmes contraintes. Déterminez combien de temps l’information peut rester ancienne sans gêner le travail. Précisez aussi le sens du transfert : envoyer des dossiers nouveaux, récupérer des résultats ou modifier des éléments déjà synchronisés.

Un fichier peut suffire lorsque les données se transfèrent par lots et qu’une personne vérifie le résultat. Une API devient intéressante lorsqu’il faut intégrer ces échanges au parcours quotidien ou obtenir un retour sur chaque opération. Mais la présence d’une API commerciale ne prouve pas que les objets et les actions nécessaires y sont réellement accessibles.

Ce qu’il faut convenir pour un CSV fiable

Le CSV est un fichier texte organisé en lignes et colonnes. La RFC 4180 décrit un format courant, notamment le rôle des en-têtes et des guillemets. Dans la pratique, les logiciels peuvent attendre des séparateurs et encodages différents. Demandez un exemple accepté par le logiciel destinataire et un export représentatif du logiciel source.

Fixez le nom et le sens des colonnes, les dates, les décimales et le traitement des cellules vides. Un identifiant pouvant commencer par zéro doit rester du texte. Vérifiez également comment représenter une suppression ou une correction : une case vide peut signifier « ne pas modifier », « effacer » ou « donnée absente », selon le contrat d’import.

Ce qu’il faut vérifier pour une API exploitable

Listez les opérations indispensables, les droits correspondants et les informations renvoyées après une écriture. Le connecteur doit gérer l’expiration d’un accès, les interruptions et les limites de débit. La documentation Microsoft Graph illustre notamment les réponses de limitation et le délai de reprise indiqué par Retry-After.

Les accès doivent rester limités au périmètre utile. Prévoyez un responsable pour leur renouvellement et une procédure de désactivation. Vérifiez aussi les évolutions annoncées par l’éditeur : une connexion nécessite de l’entretien si des champs changent ou si une version de l’interface est retirée. L’accès technique à une API et le fonctionnement durable d’une intégration sont deux sujets distincts.

Exemple hypothétique : transmettre des interventions terminées

Une entreprise exporte ses interventions terminées pour préparer la facturation. Si ce travail se fait par lots contrôlés, un CSV peut être adapté : chaque ligne porte un identifiant stable et le logiciel signale les lignes acceptées ou refusées. Les corrections se font sur les lignes en erreur sans recréer les autres.

Si un collaborateur doit voir immédiatement dans l’application qu’une intervention a été facturée, une API avec confirmation peut mieux correspondre au besoin. Le choix ne se résume pourtant pas à la rapidité : une combinaison est possible, avec un premier import historique par fichier puis des mises à jour ciblées. Cet exemple est hypothétique et ne présume pas les capacités d’un logiciel précis.

Préparer les doublons, corrections et retours d’erreur

Quel que soit le mode de transfert, définissez la clé qui représente un même dossier dans les deux systèmes. Le nom d’un client n’est généralement pas un identifiant suffisant. Conservez la relation entre la référence source et la référence créée à destination pour retrouver un élément après son changement de libellé.

Un échec doit indiquer ce qui a été accepté, ce qui reste à traiter et si une reprise est possible. Si le logiciel ne fournit qu’un résultat global, l’intégration doit en tenir compte et prévoir une vérification adaptée. Un import dont on ne connaît pas l’état final ne doit pas être relancé aveuglément, au risque de multiplier les dossiers.

Comparer les solutions avec un même scénario d’essai

Avant de décider, demandez une démonstration sur le même petit ensemble de données représentatives. Incluez une correction et une interruption, pas seulement une création réussie. Comparez le travail demandé à votre équipe, les contrôles disponibles et la maintenance, plutôt que le seul nombre d’étapes à l’écran.

• Le logiciel offre-t-il les champs et opérations requis dans la version utilisée ?
• Qui déclenche le transfert et qui voit une erreur ?
• Comment reconnaître une ligne déjà importée et corriger un dossier ?
• Comment retrouver la dernière synchronisation réussie ?
• Quels coûts d’accès, de préparation des données et de maintenance faut-il chiffrer ?
• Comment suspendre le flux et récupérer les données si la connexion change ?