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.