Authentification

Toutes les requêtes API nécessitent une authentification OAuth 2.0. Vous devez d'abord créer des identifiants API dans votre instance Automation, puis les utiliser pour obtenir un token d'accès.

Étape 1 : Créer des identifiants API

1. Rendez-vous dans Paramètres → Identifiants API de votre instance Automation (/s/credentials/new)
2. Saisissez un Nom pour votre application
3. Pour le flux Authorization Code : ajoutez votre ou vos Redirect URI
4. Enregistrez — vous recevrez un Client ID et un Client Secret

info

Le type d'octroi Client Credentials n'est disponible que pour les identifiants créés par des utilisateurs administrateurs. Les utilisateurs non administrateurs ne peuvent utiliser que le flux Authorization Code.

Étape 2 : Obtenir un token d'accès

Client Credentials

Idéal pour les intégrations serveur à serveur où aucune interaction utilisateur n'est nécessaire.

curl -X POST https://{your-domain}/oauth/v2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}"

Authorization Code

Idéal pour un accès délégué par l'utilisateur où un utilisateur autorise votre application.

1. Redirigez l'utilisateur pour l'autorisation :

GET https://{your-domain}/oauth/v2/authorize
  ?client_id={client_id}
  &response_type=code
  &redirect_uri={your_redirect_uri}

2. L'utilisateur se connecte et approuve l'accès. Il est redirigé vers votre URI avec un paramètre code.

3. Échangez le code contre un token :

curl -X POST https://{your-domain}/oauth/v2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "code={authorization_code}" \
  -d "redirect_uri={your_redirect_uri}"

Réponse du token

{
  "access_token": "YTc3M2UxYzYxN2Y...",
  "expires_in": 3600,
  "token_type": "Bearer",
  "scope": null,
  "refresh_token": "NTJjNjAzOGI3MT..."
}

Champ	Description
access_token	Le token à inclure dans les requêtes API
expires_in	Durée de vie du token en secondes (par défaut : 3600 — 1 heure)
token_type	Toujours Bearer
refresh_token	À utiliser pour obtenir un nouveau token d'accès sans se ré-authentifier

Étape 3 : Utiliser le token

Incluez le token d'accès dans l'en-tête Authorization de chaque requête API :

curl https://{your-domain}/api/contacts \
  -H "Authorization: Bearer {access_token}" \
  -H "Accept: application/json"

Rafraîchir les tokens

Les tokens d'accès expirent après 1 heure par défaut. Utilisez le refresh token pour obtenir un nouveau token d'accès sans imposer à l'utilisateur de ré-autoriser l'accès :

curl -X POST https://{your-domain}/oauth/v2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=refresh_token" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "refresh_token={refresh_token}"

Les refresh tokens expirent après 14 jours par défaut.