Suppression des Appels Dépréciés
En plus de la réorganisation de l'API Reference et de l'annonce de la dépréciation d'une liste limitée d'opérations V4 en doublon, nous annonçons également la date de fin de service d'un certain nombre d'opérations qui étaient déjà signalées comme dépréciées dans le portail des développeurs.
Comme ces opérations ont déjà été marquées comme dépréciées il y a longtemps, elles sont très peu utilisées. Leur suppression n’impactera pratiquement pas vos intégrations.
L'explication détaillée des opérations dépréciées utilise les anciens schémas d'URL (avant la Réorganisation de l'API Reference), car ce sont certainement les paths utilisés dans votre code.
Le nouveau schéma d'URL de ces opérations dépréciées est accessible en cliquant sur les liens vers le Developers Portal.
Les remplacements équivalents sont toujours documentés avec les nouveaux schémas d'URL, car les adaptations doivent être faites avec le path à jour.
Récupérer les résultats et les fichiers d'erreurs d'une ETL mono fichier
L'opération 'Get a single ETL execution's errors files' est un appel V5 qui permettait de récupérer le fichier d'erreur d'une exécution ETL.
> GET /v5/entities/{entity}/etl-executions/{executionId}/errors
Elle peut être remplacée par l'opération V5 'Get a single ETL execution's output files' qui permet de récupérer à la fois l'erreur et le fichier résultat de cette exécution.
> GET /mass-imports/v5/entities/{entity}/etl-executions/{executionId}/output-files
La génération des deux fichiers dépend du résultat de l'ETL et de l'activation ou non de leur génération dans la définition ETL.
L'opération pour 'Get a single mono file ETL execution's results' est un appel V5 qui était utilisé avant le développement des ETLs multi-fichiers.
> GET /v5/entities/{entity}/etl-executions/{executionId}/results
Il peut être remplacé par l'opération V5 'Get a single ETL execution's results', qui marche peut importe le nombre de fichiers traités par l'ETL.
> GET /mass-imports/v5/entities/{entity}/etl-executions/{executionId}/integration-results
Timing
Les opérations dépréciées continueront à fonctionner jusqu'au 6 mai 2025.