Du kannst Mitarbeiter aus deinem Quellsystem über unsere REST-API an actimo übermitteln. Damit kannst du drei Kernaufgaben erledigen: Mitarbeiter in Actimo erstellen, aktualisieren und löschen.

Grenzwerte für API-Aufrufe/Aufforderungen:

Es gibt ein Limit von 20 API-Anfragen/Aufrufen pro API-Schlüssel und pro Sekunde.

API Doc: https://app.swaggerhub.com/apis-docs/Actimo/Actimo

API-Schlüssel: Lass einen Administrator deiner Plattform deinen Integrationsspezialisten kontaktieren.

Springe zu: Beziehung zwischen Manager und Mitarbeiter herstellen

Die API verstehen

• Ein Mitarbeiter in actimo wird als Kontakt bezeichnet. Jede davon erhält eine eigene ID, die du zum Aktualisieren oder Ändern verwenden kannst.

• Du kannst alle API-Aufrufe in unserer Benutzeroberfläche über die Registerkarte "Entwickeln" sehen. Wenn du vom Eigentümer einen Admin-Login für die Plattform erhältst, kannst du Aufrufe und Nutzdaten kopieren/einfügen, indem du die Aktionen in der Benutzeroberfläche ausführst.

• Actimo verfügt nicht über eine Sandbox-Umgebung. Wir empfehlen, die Anrufe auf der Produktionsplattform mit 1-2 Testkontakten zu tätigen oder deinen Customer Success Manager zu kontaktieren, wenn du eine Testplattform benötigst.

• Die API von Actimo ist im JSON-Format.

• Actimo wird mit Standardfeldern wie "Vorname" und "Nachname" geliefert. Zweitens ist es auch möglich, bei Bedarf eigene Felder zu erstellen. Beachte, dass die Standardfelder logische Namen nach den Daten haben, die sie enthalten, während die benutzerdefinierten Felder data1, data2 usw. heißen. Du kannst diese Namen auf der Registerkarte "Entwickler" in der Benutzeroberfläche sehen.

Kontakte erstellen

Um einen Kontakt in actimo zu erstellen, brauchst du den folgenden Aufruf.

POST: https://a.actimo.com/api/v1/contacts

Füge dem Body die Nutzdaten hinzu, die du dem Kontakt hinzufügen möchtest.

Kontakte löschen

Um einen Kontakt in actimo zu löschen, brauchst du den folgenden Aufruf.

DEL: https://a.actimo.com/api/v1/contacts?forceAnonymize=false&ids=8562180&ids=8562181&ids=8562182

In diesem Beispiel löschen wir drei Kontakte auf einmal, die durch die fett markierten Parameter gekennzeichnet sind.

Kontakte aktualisieren

Um einen Kontakt in actimo zu aktualisieren, brauchst du den folgenden Aufruf.

PUT: https://a.actimo.com/api/v1/contacts/"contact id"

Füge dem Body die Nutzdaten hinzu, die du bei den Kontakten aktualisieren möchtest.

Add-on: Erstellen einer Beziehung zwischen Manager und Mitarbeiter

Wenn du eine Beziehung zwischen Manager- und Mitarbeiterkontakten herstellen möchtest, musst du den folgenden Aufruf durchführen. Denke daran, dass du die Kontakt-ID sowohl des Managers als auch des Mitarbeiters verwenden musst.

PUT: https://a.actimo.com/api/v1/contacts/8562183/relationships

Noch Fragen?

Bei Fragen zur API kannst du dich an einen unserer Integrationsspezialisten wenden. Wenn du bei Actimo an Bord bist, hast du bereits direkten Kontakt zu einem Spezialisten.

Bitte lass uns auch wissen, ob dies hilfreich war, indem du auf die Emoji's unten klickst oder uns ein Feedback über support@actimo.com schickst .