Hjem OppdragFinn frilansoppdrag FakturereSlik fungerer fakturering UtbetaleAdministrer oppdragstakere SupportKundeservice og hjelp
Land
Språk
Lag en gratis konto

For utviklere

EasyFreelance Partner API

Et REST-API for partnere som vil opprette oppdragstakere, kjøre dem gjennom onboarding og verifisering, og sende utbetalinger på samlefaktura – uten å gå veien om Web Panel.

Kom i gang Se endepunktene på engelsk
OpenAPI 3.0.3 · versjon 1.2.0 Eget testmiljø

To miljøer

Alle endepunkter ligger under /api/v1. Du får separate API-nøkler og tokens for produksjon og test, så en integrasjon kan kjøres helt ferdig mot testmiljøet før den settes i drift.

Produksjonhttps://app.easyfreelance.no/api/v1
Testmiljøhttps://test.easyfreelance.no/api/v1
Første kall
curl --location --request GET 'https://test.easyfreelance.no/api/v1/users?page=1&page_size=25' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'API-key: <api-nøkkel>'

Slik kommer du i gang

  1. Hent nøkler i Web Panel

    Under API-innstillingene til partnerkontoen genererer du et token og en API-nøkkel. Begge sendes med på hver eneste forespørsel, og du får ett sett per miljø.

  2. Opprett eller koble en oppdragstaker

    POST /users med en e-postadresse. Finnes e-posten fra før, kobles den eksisterende brukeren til partnerkontoen deres i stedet for at det opprettes en ny.

  3. Kjør oppdragstakeren gjennom onboarding

    Vilkår, profil, bankkonto og ID-verifisering. Feltet onboarding på brukeren forteller til enhver tid hva som gjenstår.

  4. Send utbetalinger

    POST /payouts tar imot én eller flere utbetalinger og samler dem på én faktura til dere. Bruk Idempotency-key så en gjentatt forespørsel ikke dobler opp.

Dokumentasjon

Start her hvis du skal bygge integrasjonen fra bunnen av.

Autentisering

Bearer-token og API-nøkkel i hver forespørsel. Separate nøkler for produksjon og test.

Feilmeldinger

Statuskoder, feilobjekter og hvordan valideringsfeil er bygget opp.

Paginering

page og page_size på alle endepunkter som returnerer lister.

Idempotens

Trygge gjentakelser med Idempotency-key – særlig ved utbetalinger.

Onboarding

De fem stegene en oppdragstaker må gjennom før dere kan utbetale.

Verifisering (KYC / ID)

Veriff og BankID – fra godkjent return-URL til terminal status.

Referanse

Alle endepunkter, gruppert slik de er gruppert i OpenAPI-spesifikasjonen.

Brukere

Opprett, koble, oppdater og slå opp oppdragstakere.

8 endepunkter på engelsk

Utbetalinger

Opprett utbetalinger på samlefaktura og hent status.

5 endepunkter på engelsk

Vilkår

Gjeldende vilkår og godkjenning per oppdragstaker.

4 endepunkter på engelsk

Verifisering

Return-URLer, verifiseringssesjoner og statusoppslag.

4 endepunkter på engelsk

Webhooks

employee.verified – utgående kall når verifisering er ferdig.

1 hendelse på engelsk

Ratebegrensning

Autentisert partnertrafikk deler én rullerende grense per API-identitet: 500 forespørsler i minuttet på tvers av alle /api/v1-ruter. Det finnes ingen egne grenser per endepunkt – polling, innloggingslenker, vilkårsoppdateringer og alt annet trekker fra samme budsjett.

429

Overskrides grensen svarer API-et 429 Too Many Requests. Responsen kan inneholde headeren Retry-After med antall sekunder til du kan prøve igjen. Legg inn eksponentiell backoff i klienten, og unngå å polle verifiseringsstatus oftere enn hvert 2.–5. sekund.

Trenger du hjelp?

Send en e-post til [email protected] med partnernavn og gjerne verification_id eller bruker-ID hvis spørsmålet gjelder en konkret oppdragstaker.