Du kan klargøre medarbejdere fra dit kildesystem til actimo ved hjælp af vores REST API. Det giver dig mulighed for at håndtere tre kerneopgaver, nemlig at oprette, opdatere og slette medarbejdere i Actimo.

Grænser for API-opkald/forespørgsler:

Der er en grænse på 20 API-anmodninger/opkald pr. API-nøgle pr. sekund.

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

API-nøgle: Få en administrator på din platform til at kontakte din integrationsspecialist.

Spring til: Skabelse af relation mellem leder og medarbejder

Forståelse af API'en

• En medarbejder i actimo kaldes en kontaktperson. Hver af disse får deres eget ID (id), som du kan bruge til at opdatere eller foretage ændringer.

• Du kan se alle API-kald i vores UI via fanen develop. Hvis du får et administratorlogin til platformen fra ejeren, kan du kopiere/indsætte kald og payload ved at udføre handlingerne i brugergrænsefladen.

• Actimo har ikke et sandkassemiljø. Vi anbefaler, at du foretager opkaldene i produktionsplatformen ved at målrette 1-2 testkontakter eller kontakte din Customer Success Manager, hvis du har brug for en testplatform.

• Actimos API er i JSON-format.

• Actimo leveres med standardfelter som "fornavn" og "efternavn". For det andet er det også muligt at oprette brugerdefinerede felter, hvis det er nødvendigt. Husk, at hvor standardfelter har logiske navne efter de data, de indeholder, vil brugerdefinerede felter hedde data1, data2 osv. Du kan se disse navne under fanen developer i brugergrænsefladen.

Oprettelse af kontakter

For at oprette en kontakt i actimo skal du bruge følgende opkald.

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

Tilføj payload til body'en med de nødvendige data, du ønsker at tilføje til den pågældende kontakt.

Slet kontakter

For at slette en kontakt i actimo skal du bruge følgende opkald.

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

I dette eksempel sletter vi tre kontakter på én gang, markeret som de parametre, der er fremhævet med fed skrift.

Opdatering af kontakter

For at opdatere en kontakt i actimo skal du bruge følgende opkald.

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

Tilføj payload til kroppen med de nødvendige data, du ønsker at opdatere på kontakterne.

Tilføjelse: Opret et forhold mellem leder og medarbejder

Hvis du ønsker at oprette en relation mellem leder- og medarbejderkontakter, skal du foretage følgende opkald. Husk, at du skal bruge både lederens og medarbejderens kontakt-id.

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

Har du spørgsmål?

Spørgsmål om API'en kan rettes til en af vores integrationsspecialister. Hvis du bliver onboardet til Actimo, vil du allerede have direkte kontakt med en specialist.

Fortæl os også gerne, om dette var nyttigt, ved at klikke på emojierne nedenfor eller sende feedback via support@actimo.com.