Sådan integrerer du med vores API

Denne guide hjælper dig med at komme godt i gang med brugen af vores API og integrere dine systemer effektivt.

Brug af Vores API

Før du kan begynde at integrere med Uniify, skal du have en virksomhed registreret på vores platform og en Uniify-brugerkonto. Vi sørger for opsætningen, så du har fuld adgang til dit team.

Konfiguration af API-nøgle og Webhook

API-nøgle:

Vi bruger Bearer token-metoden til godkendelse. Denne metode tildeler hver bruger et unikt token, som bruges til at få adgang til beskyttede ressourcer uden at sende brugernavn og adgangskode for hver anmodning, hvilket øger sikkerheden.

Sådan gør du:

1. Log ind i Uniify.

2. Gå til Indstillinger og find sektionen API.

3. Klik på Generer token.

4. Giv dit token et navn (f.eks. "CRM integration") og vælg rettighederne Read og Write.

Webhook:
For at opsætte webhooks, se vores artikel om Opsætning af Webhook. Når du har opsat webhooks og genereret en token, er du klar til at bruge API'et.

Kom i gang

Opret en sag med en POST-request:

1. Definér to body parametre: en generisk case_type_code og et label, der repræsenterer sagsnavnet.

2. Opdater case_type_code afhængigt af hvilken flow type (Privatperson eller Virksomhed) du vil kalde.

3. Inkludér flow_code i entitetsobjektet for at specificere det flow, der skal anvendes. Dette findes på platformen.

Webhook-svar:

1. Efter ovenstående trin skulle webhook'en give svaret "COMPLETED", hvis operationen er fuldført.

Hent data med en GET-request:

1. Brug get_entity_flow GET-request for at hente al data fra en given sag.

2. Definér tre path parametre: case_code, entity_code (repræsenterer en person/virksomhed), og entity_flow_code (et unikt id, der forbinder den individuelle enhed med det tilhørende flow). Alle tre parametre returneres i det foregående POST-request.

Brug for hjælp til integrationen?
Hvis du oplever problemer med dit API-token, eller hvis dokumentationen rejser spørgsmål, sidder vi klar til at hjælpe. Skriv til os i chatten eller på support@uniify.io, så hjælper vi jeres tekniske team i gang.