Utiliser les webservices

ACTITO vous permet d'interagir avec ses données par le biais d'une API de type REST. Celle-ci vous permet d'effectuer diverses opérations de création, de mise à jour et de suppression.

Cette page vous renseigne sur le fonctionnement et les contraintes liées à cette API.

Méthodes utilisées dans les webservices

Les opérations disponibles via les webservices ACTITO sont regroupées en 4 méthodes qui ont chacune leurs fonctionnalités propres : GET, PUT, POST et DELETE

images/download/attachments/615292214/image2019-3-13_14-37-1.png

La méthode GET

Cette méthode récupère une représentation de la ressource sur laquelle est basée la requête. Il s'agit d'une méthode de lecture seule, c'est à dire que l'appliquer sur une ressource ne résulte pas en un changement d'état de la ressource. C'est donc une méthode sûre.

Elle permet principalement d'extraire des informations depuis ACTITO, soit pour les traiter par vos autres systèmes (profils, campagnes existantes, ...), soit pour obtenir des informations structurelles dans le but de faciliter l'implémentation des autres méthodes (obtenir la structure d'une base de données, ...)

La méthode POST

Cette méthode permet de créer une ressource dans la collection de ressources, en utilisant les données introduites dans le corps de la requête.

Elle est principalement utilisée pour la création de nouveaux éléments, mais elle peut aussi parfois être utilisée dans le cas de leur mise à jour.

La méthode PUT

Cette méthode permet de remplacer la représentation d'une ressource en utilisant les données introduites dans le corps de la requête, ou de créer une nouvelle ressource si celle-ci n'existe pas encore.

Elle est principalement utilisée pour la mise à jour d'éléments, mais son comportement implique qu'elle puisse aussi parfois être utilisée pour des créations.

La méthode DELETE

Cette méthode supprime toutes les représentations d'une ressource.

Il peut s'agir de supprimer un élément précis (désabonner un profil d'un abonnement) ou un élément plus général (supprimer un profil ou un e-mail en définition).

Format des webservices

Les APIs d'ACTITO supportent le format JSON et le format XML. Cependant, le format XML est désormais obsolète. Les nouveaux appels webservices mis à disposition, ou les mises à jour sur les appels existants, ne sont plus disponible dans le format XML, qui n'est plus documenté. Tous les exemples utilisés dans ce chapitre seront donc au format JSON. Les APIs existants supportent toujours le format XML, jusqu'à nouvel avis.

Nous vous recommandons donc fortement de basculer vers le format JSON. Si vous êtes peu familier avec ce format, il vous est possible de valider votre code avec l'aide du site suivant : https://jsonlint.com/

Lors de la création ou la mise à jour à distance d'un élément, il est nécessaire de préciser le type de format attendu dans le contenu de la réponse. Dans la documentation technique qui vous aide à créer vos appels, il vous faut alors choisir entre XML et JSON dans le menu déroulant qui vous est proposé face au champ "Response Content Type".

images/download/attachments/615292214/image2019-3-13_11-22-6.png

Utilisation optimale des webservices

Afin de garantir une utilisation optimale des webservices, certaines frontières d'utilisation ont été mises en place :

  • Nombre maximum d'utilisateurs webservices par licence : 5

  • Nombre maximum d'appels par minute : 60

  • Nombre maximum d'appels de masse par jour : 12

  • Nombre maximum de requêtes simultanées par licence : 5

  • Taille maximum du fichier zippé pour un appel de masse : 100 Mo

Le dépassement de ces seuils conduira à une erreur ou à un ralentissement des performances.