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:
For at generere en unik bearer token til din virksomhed, gå til Indstillinger → API på platformen, opret et nyt token og vælg både read og write rettigheder.
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:
Definér to body parametre: en generisk
case_type_code
og etlabel
, der repræsenterer sagsnavnet.Opdater
case_type_code
afhængigt af hvilken flow type (Individ eller Virksomhed) du vil kalde.Inkludér
flow_code
i entitetsobjektet for at specificere det flow, der skal anvendes. Dette findes på platformen.
Webhook-svar:
Efter ovenstående trin skulle webhook'en give svaret "COMPLETED", hvis operationen er fuldført.
Hent data med en GET-request:
Brug
get_entity_flow
GET-request for at hente al data fra en given sag.Definér tre path parametre:
case_code
,entity_code
(repræsenterer en person/virksomhed), ogentity_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.