Aller au contenu principal

Webservices

Actito a pour vocation de vous proposer une grande connectivité dans votre approche marketing. De ce fait, nous veillons particulièrement à permettre les échanges de données entre Actito et les autres systèmes, propres à votre activité.

L'API publique mises à votre disposition vous permettent dès lors d'interagir directement avec Actito sans devoir passer par l'interface. Par le biais des webservices, vous allez être en mesure d'appeler des données présentes dans Actito et d'obtenir ces données comme réponse. Vous pouvez également programmer l'envoi des données de votre système vers Actito.

Plus qu'un simple procédé d'échange de données, les webservices Actito vous permettent également d'activer l'utilisation de ces données, mais aussi d'en automatiser le traitement.

En effet, l'API se compose d'une série de routes, groupées en catégories correspondant aux différents canaux et applications d'Actito. Pratiquement tout ce qui peut être réalisé dans l'interface Actito peut être automatisé à travers notre API publique.

Alt text

Accès aux API Publiques​

Actito met à disposition des accès Webservices dans 4 environnements : 1 environnement de PREPROD et les 3 environnements de PROD.

La documentation technique est disponible en ligne et en anglais sur notre portail dévelopeurs. Elles sont constamment maintenues à jour.

Avertissement

La section "Webservices" de la documentation plateforme sert à vous donner une perspective business de ce qui est possible de faire à travers l'API Actito.

Pour les détails d'implémentation, les dévelopeurs doivent toujours se référer aux spécifications API sur le Developers Portal (lien ci-dessus).

Création de compte utilisateur Webservices et authentification​

L’utilisation des API se fait de manière authentifiée. Il s'agit de comptes spécifiques séparés des comptes utilisateurs pour la plateforme.

L'API Actito utilise une authentification basée sur le principe de clé API.

Authentification par clé API​

Les utilisateurs Adminstrateurs de votre licence a la possibilité de paramétrer directement vos clés API (voir "Gérer les utilisateurs API")

Astuce

Lors de la création d'utilisateur API, il convient de l'associer à l'adresse e-mail d'une personne responsable de la maintenant de vos API. En effet, cette addresse sera utilisée pour vous notifier de tout changement impactant vos intégrations.

Pour paramétrer des appels API, la clé API ne doit pas être utilisée directement comme identifiant.

Elle va servir a générer un token d'accès à la validité limitée dans le temps (15 minutes), qui lui devrait être poussé dans tous les appels.

Par exemple, pour générer un token en environnement de TEST, l'appel sera

GET https://api-pre1.actito.com/auth/token

avec la clé API dans l'entête 'Authorization'

GET Token

curl
 -X GET 'https://api-pre1.actito.com/auth/token' \
 -H 'Authorization: qhdfbvdh747R49FRHrthqXXXXXXX' \
 -H 'Accept: application/json'

Vous obtiendrez un token (dans le paramètre 'accessToken' de la réponse)

Reponse GET Token

{
 "accessToken": "AAAAAAAAAAAAAAAAAAAAAMLheAAAAAAA0%2BuSeid%2BULvsea4JtiGRiSDSJSI%3DEUifiRBkKG5E2XzMDjRfl76ZC9Ub0wnz4XsNiRVBChTYbJcE3F",
 "tokenType": "bearer",
 "expiresIn": "900s",
 "scope": "read write",
 "jti": "ce6c1d3c-ab49-4b62-8f4c-964351ac5d58"
}

Le token obtenu servira à l'authentification de tous les appels dans les 15 minutes suivantes. Il devra être passé comme 'Authorization' de type 'Bearer' dans tous les appels.

Exemple Bearer Token

curl
 -X GET 'https://api-pre1.actito.com/v5/entities/MyEntity/etls' \
 -H "Authorization: Bearer
                      AAAAAAAAAAAAAAAAAAAAAMLheAAAAAAA0%2BuSeid%2BULvsea4JtiGRiSDSJSI%3DEUifiRBkKG5E2XzMDjRfl76ZC9Ub0wnz4XsNiRVBChTYbJcE3F" \
 -H 'Accept: application/json'

Version des API publiques​

Actito améliore son produit quotidiennement et travaille activement à élargir sa plateforme d'Intégrations.

Toutes les dernières routes développées peuvent être reconnues au v5 dans leur path. La philosophie de la V5 est de suivre de près les usages standards des API REST et d'améliorer la cohérence de leur comportement selon les ressources.

Il n'est pas prévu d'entièrement déprécier la V4 ou de la remplacer dans son ensemble avec des routes V5. Cependant, des changements peuvent survenir sur des routes V4 individuelles. Elles seront annoncées à travers le processus documenté ici.

Concepts Actito accessibles par Webservices​

Chaque opération est regroupée sous un concept, qui correspond à la catégorie de ressources Actito sur laquelle l'opération va être appliquée.

Chacun de ces concepts peut faire appel à une ou plusieurs méthodes, selon sa nature et selon les opérations s'y rapportant qu'il est possible de faire.

Pour vous familiariser avec les différents concepts avec lesquels il est possible d'interagir via l'API Actito, nous vous invitons à lire le chapitre consacré aux "Concepts Actito accessibles par Webservice".