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'en décembre 2024.
Methodes PUT pour la définition des campagnes e-mail et SMS
Une série d'opération pour 'Set the HTML content', 'Set the personalization file' et 'Set the target file' des campagnes e-mail/SMS utilisant la méthode PUT sont dépréciées depuis l'apparition des opérations équivalentes avec la méthode POST.
Les opérations suivantes seront supprimées, car les mêmes routes avec la méthode POST sont utilisées à la place.
> PUT /v4/entity/{entity}/mail/{campaign}/content/body
> PUT /v4/entity/{entity}/mail/{campaign}/personalization
> PUT /v4/entity/{entity}/mail/{campaign}/target/list
> PUT /v4/entity/{entity}/sms/{campaign}/personalization
> PUT /v4/entity/{entity}/sms/{campaign}/target/list
Timing
Les opérations ci-dessus sont signalées comme dépréciées depuis des années et n'ont enregistré aucune utilisation récemment.
Elles seront supprimées à compter de août 2025.
Ancien appel pour "Créer un wehook sur une table de profil/personnalisée
Les opérations pour 'Create a webhook on a profile table' et 'Create a webhook on a custom table' ont été signalés comme dépréciées depuis l'introduction d'une opération générique de création de webhooks, où les événements ciblés sont définis dans le corps de l'appel.
Les opérations suivantes seront supprimées :
> POST /v4/entity/{entity}/table/{table}/webhookSubscription
> POST /v4/entity/{entity}/customTable/{table}/webhookSubscription
Leur remplacement est l'opération générique
> POST /webhooks/v4/entity/{entity}/webhookSubscription
Dans cet appel, les éléments écoutés par le webhook sont définis par le paramètre "on" (par exemple "CUSTOM_TABLE" ou "PROFILE_TABLE").
Timing
Les opérations ci-dessus sont signalées comme dépréciées depuis des années et n'ont connu aucune utilisation récemment.
Ils seront supprimés à compter de août 2025.