Passer au contenu principal
Téléchargez directement les détails des appels API du compte actuel au format CSV, adapté au rapprochement financier, à l’analyse hors ligne ou à la conservation de grands volumes d’enregistrements. Si vous devez seulement consulter un petit nombre de détails sur la page, utilisez d’abord la liste des enregistrements d’appels. La plage de requête des enregistrements d’appels et des résumés de facturation couvre les 60 derniers jours ; les corps des requêtes et des réponses sont conservés séparément pendant les 30 derniers jours. L’expiration des corps ne modifie pas les frais réels, l’utilisation ou les statistiques agrégées de cet enregistrement.

Préparatifs

  1. Connectez-vous à la plateforme AceDataCloud.
  2. Créez un jeton de compte dans la console Account Token, puis enregistrez-le immédiatement dans un gestionnaire de mots de passe ou Secret Manager.
  3. Obtenez, selon vos besoins, les ID de filtrage depuis la liste des demandes de service, la liste des identifiants API ou la liste des API.
Pour une description complète des jetons, consultez Gérer les jetons de compte. Les jetons de compte et les Credential utilisés pour appeler les API métier ne peuvent pas être utilisés indifféremment.

Aperçu de l’interface

Cette interface renvoie le CSV de manière synchrone et en flux, ne crée pas de tâche d’exportation et ne renvoie ni JSON ni lien de téléchargement. Ce n’est que lorsque les deux heures de début et de fin ne sont pas fournies que les enregistrements depuis le début du mois civil actuel jusqu’au moment actuel sont exportés par défaut ; lorsqu’une seule limite est fournie, l’autre ne sera pas automatiquement complétée par la limite du mois actuel.

Paramètres de requête

La portée d’exportation est toujours limitée aux enregistrements visibles par le compte actuel en tant qu’entité de paiement et/ou appelant réel, et l’exportation inter-comptes n’est pas prise en charge.

Exemples de requêtes

Enregistrer directement le CSV du mois actuel :
Exporter par Application, heure et code d’état :
Enregistrement Python en flux et vérification de l’intégrité :

Colonnes CSV

L’ordre de l’en-tête CSV est fixe :
L’unité de montant est déterminée par service.unit de l’Application correspondante.

Déterminer si l’exportation est complète

Une seule exportation peut produire au maximum 1 000 000 lignes de données. Une fois que le serveur a commencé à renvoyer le CSV, il ne peut plus modifier une erreur intermédiaire en un autre état HTTP ; le client doit donc vérifier la dernière ligne :
  • # truncated: : la limite de lignes est atteinte ; exportez par segments avec des fenêtres temporelles plus petites.
  • # error: : la lecture en flux est interrompue ; réduisez la plage puis exportez à nouveau.
Lorsqu’un programme de rapprochement voit l’un ou l’autre marker, il doit considérer le fichier comme incomplet et ne peut pas le comptabiliser silencieusement.

Erreurs et nouvelles tentatives

Étapes suivantes