L'API Dux-Soup

Vue d'ensemble 

L'API de Dux-Soup vous permet de contrôler et d'automatiser tous les aspects de votre approche de LinkedIn. Cette API ouverte peut être utilisée par toute personne possédant une licence Dux-Soup Turbo ou Cloud Edition. Les sous-API suivantes sont incluses :

API d'activité LinkedIn

Cette API permet de planifier les activités à exécuter par l'extension Dux-Soup. Les activités LinkedIn sont toujours ajoutées à une file d'attente afin de permettre à l'activité d'être limitée en fonction des paramètres de l'utilisateur. Cette API était auparavant connue sous le nom d'API de contrôle à distance.

Parcourir l'API de l'activité LinkedIn

Paramètres de l'utilisateur API

Cette API fournit un accès complet en lecture et en écriture à tous les paramètres de configuration de l'utilisateur de Dux-Soup.

Parcourir l'API des paramètres de l'utilisateur

API de contrôle des extensions

Cette API permet d'accéder à un sous-ensemble d'actions disponibles de l'interface utilisateur qui sont couramment déclenchées par l'utilisateur final. 

Parcourir l'API de contrôle des extensions

API de gestion des files d'attente

Cette API permet d'accéder à l'activité en file d'attente et de la contrôler.

Parcourir l'API de gestion des files d'attente

Profil de l'utilisateur API

Cette API permet d'accéder aux détails de l'utilisateur final.

Parcourir l'API du profil de l'utilisateur

Prospect API

Cette API permet d'accéder aux détails des prospects d'une campagne.

Parcourir l'API Prospect

Connexion à l'API 

Chaque sous-API possède sa propre URL ou, dans certains cas, plusieurs URL. Veuillez vous référer à chaque sous-API spécifique pour ces détails.

Authentification des appels API

Tous les appels API à Dux-Soup nécessitent une authentification. L'authentification des appels à l'API se fait à l'aide d'un en-tête signé cryptographiquement "X-Dux-Signature : [SomeHash]". Ce calcul est effectué à l'aide de la clé d'authentification qui se trouve dans Dux-Soup Options -> Connect.

La valeur peut être calculée à l'aide de la fonction Javascript suivante. Dans cet exemple de code, nous utilisons la bibliothèque Javascript jsSHA [1], mais n'importe quelle bibliothèque SHA fonctionnera tant qu'elle prend en charge les sorties codées SHA-1, HMAC et BASE64 :

function calculateHMAC(apikey, message){

var shaObj = new jsSHA("SHA-1", "TEXT") ;

shaObj.setHMACKey(apikey, "TEXT") ;

shaObj.update(message) ;

var hmac = shaObj.getHMAC("B64") ;

retour hmac ;

}

  • Pour les requêtes HTTP POST Les entrées de la fonction sont 1) l'apikey de l'utilisateur, tel qu'il se trouve dans le panneau d'options, et 2) le JSON BODY de la requête HTTP.
  • Pour les requêtes HTTP GET Les entrées de la fonction sont 1) le code d'accès de l'utilisateur et 2) l'URL du point de terminaison de l'API de la requête HTTP. 

The resulting HMAC contains the required hash. This hash needs to be included as a HTTP Header value: ‘X-Dux-Signature: <<HMAC>>’.

Champs obligatoires

Tous les appels POST à l'API Dux-Soup nécessitent un corps de requête JSON. 

En outre, les en-têtes HTTP suivants doivent être inclus

Type de contenu application/json
X-Dux-Signature Valeur HMAC valide (voir ci-dessus)

Le corps du message HTTP doit contenir un objet JSON avec les champs suivants, afin d'être accepté par le serveur :

targeturl L'URL cible de cette commande, où la commande est délivrée. Doit commencer par https://app.dux-soup.com
horodatage Heure 'unix' actuelle en millisecondes. L'horodatage doit se situer à moins de 5 minutes de l'heure actuelle.
nom d'utilisateur L'identifiant de l'utilisateur auquel la commande sera envoyée pour exécution. Il doit correspondre à l'identifiant de l'URL cible.

Test des appels API

Dux-Soup comprend un outil qui vous permet d'exécuter n'importe quel appel d'API, ou de générer les commandes 'curl'[2] correspondantes à exécuter à partir d'une ligne de commande. C'est le moyen le plus simple d'essayer l'API. Pour utiliser cet outil, il suffit de diriger votre navigateur vers https://app.dux-soup.com/web/rc/test

Démonstration: Voyez comment générer la commande curl pour insérer une demande de connexion dans la file d'attente. Voyez comment exécuter l'appel API à partir de l'outil de test et apprenez où trouver l'activité nouvellement mise en file d'attente.