Die Dux-Soup API

Übersicht

Mit der Dux-Soup API können Sie alle Aspekte Ihrer LinkedIn-Kontaktaufnahme steuern und automatisieren. Diese offene API kann von jedem genutzt werden, der eine Dux-Soup Turbo oder Cloud Edition Lizenz besitzt. Die folgenden Sub-APIs sind enthalten:

LinkedIn Aktivität API

Diese API ermöglicht die Planung von Aktivitäten, die von der Dux-Soup-Erweiterung ausgeführt werden sollen. LinkedIn-Aktivitäten werden immer zu einer Warteschlange hinzugefügt, damit die Aktivität entsprechend den Einstellungen des Benutzers gedrosselt werden kann. Diese API war früher als Remote Control API bekannt.

Durchsuchen Sie die LinkedIn-Aktivitäts-API

Benutzereinstellungen API

Diese API bietet vollständigen Lese- und Schreibzugriff auf alle Dux-Soup-Benutzerkonfigurationsparameter.

Durchsuchen Sie die Benutzereinstellungen-API

Erweiterungssteuerung API

Diese API bietet Zugriff auf eine Teilmenge der verfügbaren UI-Aktionen, die häufig vom Endbenutzer ausgelöst werden.

Durchsuchen der Extension Control API

API für die Warteschlangenverwaltung

Diese API ermöglicht den Zugriff auf und die Kontrolle über die Aktivität in der Warteschlange.

Durchsuchen Sie die Warteschlangen-Verwaltungs-API

Benutzerprofil-API

Diese API ermöglicht den Zugriff auf die Details des Endnutzers.

Durchsuchen Sie die Benutzerprofil-API

Aussicht auf API

Diese API ermöglicht den Zugriff auf die Details der Interessenten in einer Kampagne.

Durchsuchen Sie die Prospect API

Verbinden mit der API

Jede Sub-API hat ihre eigene URL, oder in manchen Fällen mehrere URLs. Bitte lesen Sie die Details zu jeder einzelnen Sub-API.

Authentifizierung von API-Aufrufen

Alle API-Aufrufe an Dux-Soup erfordern eine Authentifizierung. Die Authentifizierung der API-Aufrufe erfolgt über einen kryptographisch signierten Header 'X-Dux-Signature: [SomeHash]'. Diese Berechnung erfolgt mit Hilfe des Authentifizierungsschlüssels, der unter Dux-Soup Optionen -> Verbinden zu finden ist.

Der Wert kann mit der folgenden Beispiel-Javascript-Funktion berechnet werden. In diesem Beispielcode verwenden wir die Javascript-Bibliothek jsSHA [1], aber jede SHA-Bibliothek funktioniert, solange sie SHA-1, HMAC und BASE64-kodierte Ausgabe unterstützt:

    Funktion calculateHMAC(apikey, message){
        var shaObj = new jsSHA("SHA-1", "TEXT");
        shaObj.setHMACKey(apikey, "TEXT");
        shaObj.update(Nachricht);
        var hmac = shaObj.getHMAC("B64");
        zurück hmac;
    }

Für HTTP-POST-Anfragen Die Eingaben für die Funktion sind 1) der apikey des Benutzers, wie er im Optionsfeld zu finden ist, und 2) der JSON BODY der HTTP-Anfrage.
Für HTTP-GET-Anfragen Die Eingaben für die Funktion sind 1) der apikey des Benutzers und 2) die URL des API-Endpunkts der HTTP-Anfrage.

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

Erforderliche Felder

Alle API POST-Aufrufe an Dux-Soup API erfordern einen JSON-Anfragekörper.

Darüber hinaus müssen die folgenden HTTP-Header enthalten sein

Inhaltstyp	anwendung/json
X-Dux-Signatur	Gültiger HMAC-Wert (siehe oben)

Der HTTP-Body muss ein JSON-Objekt mit den folgenden Feldern enthalten, um die Akzeptanz durch den Server sicherzustellen:

Zielurl	Die Ziel-URL dieses Befehls, an die der Befehl übermittelt wird. Sollte mit https://app.dux-soup.com beginnen.
Zeitstempel	Aktuelle 'unix'-Zeit in Millisekunden. Der Zeitstempel muss innerhalb von 5 Minuten nach der aktuellen Zeit liegen.
Benutzerkennung	Die Benutzerkennung, an die der Befehl zur Ausführung gesendet wird. Sollte mit der Userid in der Ziel-URL übereinstimmen.

Testen von API-Aufrufen

Dux-Soup enthält ein Tool, mit dem Sie jeden API-Aufruf ausführen oder die entsprechenden 'curl'-Befehle [2] generieren können, um sie von der Kommandozeile auszuführen. Das ist der einfachste Weg, die API auszuprobieren. Um dieses Tool zu verwenden, zeigen Sie einfach mit Ihrem Browser auf https://app.dux-soup.com/web/rc/test.

Demo: Sehen Sie, wie Sie den curl-Befehl zum Einfügen einer Verbindungsanfrage in die Warteschlange erzeugen. Sehen Sie, wie der API-Aufruf vom Testwerkzeug aus ausgeführt wird, und erfahren Sie, wo Sie die neu in die Warteschlange gestellte Aktivität finden.

[1] Siehe https://github.com/Caligatio/jsSHA