HireHop baut auf einer API auf, was bedeutet, dass Sie alles, was Sie von HireHop sehen, auch mit der umfangreichen API erreichen können. Um auf die Rest-API zuzugreifen, benötigen Sie lediglich ein Benutzertoken, das als GET oder POST auf den entsprechenden URL-Endpunkt angewendet wird.
API-Token
Um ein API-Token zu generieren, gehen Sie zur Seite „Einstellungen“ und wählen Sie die Registerkarte „Benutzer“. Wählen oder erstellen Sie einen Benutzer, klicken Sie dann, während dieser bestimmte Benutzer ausgewählt ist, auf die Schaltfläche „Menü“ und dann auf die Option „API-Token“, um ein Token zu generieren. Der Token wird dann angezeigt und kann mit der Schaltfläche Kopieren in die Zwischenablage kopiert werden.
Das Token wird ungültig, wenn Sie die E-Mail-Adresse oder das Passwort des ausgewählten Benutzers ändern oder sich anschließend bei diesem Benutzer anmelden. Um dies zu verhindern, sollten Sie einen dedizierten API-Benutzer erstellen und ihm aus Sicherheitsgründen die entsprechenden Berechtigungen erteilen, um ihn auf alles einzuschränken, für das Sie die API nicht verwenden.
Aus Sicherheitsgründen sollten Sie das Token nicht im Frontend-JavaScript-Code verwenden, es sollte nur serverseitig verwendet werden. Wenn ein Hacker den Token erhält, kann er Ihre Daten auf HireHop ändern und darauf zugreifen, also halten Sie Ihren Token geheim. Wenn Ihr Token durchgesickert ist, ändern Sie einfach das Passwort des API-Benutzers und generieren Sie einen neuen Token.
Verwenden eines Tokens
Ein Token sollte als GET- oder POST-Parameter festgelegt werden, der als „Token“ bezeichnet wird. Um beispielsweise Jobdaten für Jobnummer 52 zu laden, ruft HireHop den API-Endpunkt auf:
https://myhirehop.com/php_functions/job_refresh.php?job=52
Wenn Sie denselben Endpunkt mit einem Token aufrufen möchten, lautet die URL:
https://myhirehop.com/php_functions/job_refresh.php?job=52&token=dqwejk5GVT65909bHHBN7922pq5hxjm%207hmn
Bitte denken Sie daran, dass Sie bei der Übergabe des Tokens über GET (ein URL-Parameter wie oben) den Token zuerst mit einem Tool wie https://meyerweb.com/eric/tools/dencoder codieren müssen.
Buchungsdaten
Um Daten in HireHop zu erstellen oder zu bearbeiten, müssen Sie einen POST verwenden. Beim Veröffentlichen von Daten sollten Sie nur die Felder setzen, die Sie ändern möchten, um beispielsweise einen Job über den Endpunkt https://myhirehop.com/php_functions/job_save.php zu erstellen oder zu bearbeiten, indem Sie den Parameter „job“ auf „0“ setzen “ oder weglassen wird ein neuer Job erstellt, alles andere ändert die entsprechende Jobnummer. Um den Firmennamen in der Stellennummer 52 zu bearbeiten, sollten die Stellendaten wie folgt lauten:
{
"job" : 52,
"name" : "New Name",
"token" : "dqwejk5GVT65909bHHBN7922pq5hxjm=-7hmn"
}
API-Endpunkte
Viele API-Endpunkte sind in der API-Dokumentation dokumentiert, viele weitere werden folgen. Um den Endpunkt für eine Aufgabe einzurichten, verwenden Sie in der HireHop-Anwendung die Browserkonsole, um die Netzwerkaufrufe und die eingestellten Parameter zu überprüfen. Eine ausführliche Anleitung zu den URL-Endpunkten wird in Kürze veröffentlicht.
Ratenbegrenzungen
HireHop erlaubt jedem Benutzer 60 Verbindungsanfragen innerhalb von 1 Minute. Wenn mehr als 60 vorhanden sind, wird der Fehler „Sicherheitswarnung, zu viele Transaktionen“ (327) zurückgegeben.