Partner API | Frilans med EasyFreelance

Två miljöer

Alla endpoints ligger under /api/v1. Ni får separata API-nycklar och tokens för produktion och test, så att en integration kan köras helt färdig mot testmiljön innan den sätts i drift.

Produktionhttps://app.easyfreelance.no/api/v1

Testmiljöhttps://test.easyfreelance.no/api/v1

Första anropet

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-nyckel>'

Så här kommer du igång

Hämta nycklar i Web Panel

Under partnerkontots API-inställningar genererar du ett token och en API-nyckel. Båda skickas med i varje enskild begäran, och du får en uppsättning per miljö.
Skapa eller koppla en uppdragstagare

POST /users med en e-postadress. Finns e-postadressen sedan tidigare kopplas den befintliga användaren till ert partnerkonto i stället för att en ny skapas.
Kör uppdragstagaren genom onboarding

Villkor, profil, bankkonto och ID-verifiering. Fältet onboarding på användaren visar hela tiden vad som återstår.
Skicka utbetalningar

POST /payouts tar emot en eller flera utbetalningar och samlar dem på en faktura till er. Använd Idempotency-key så att en upprepad begäran inte dubblerar.

Dokumentation

Börja här om du ska bygga integrationen från grunden.

Autentisering

Bearer-token och API-nyckel i varje begäran. Separata nycklar för produktion och test.

Felmeddelanden

Statuskoder, felobjekt och hur valideringsfel är uppbyggda.

Paginering

page och page_size på alla endpoints som returnerar listor.

Idempotens

Säkra upprepningar med Idempotency-key – särskilt vid utbetalningar.

Onboarding

De fem stegen en uppdragstagare måste gå igenom innan ni kan betala ut.

Verifiering (KYC / ID)

Veriff och BankID – från godkänd return-URL till terminal status.

Referens

Alla endpoints, grupperade så som de är grupperade i OpenAPI-specifikationen.

Användare

Skapa, koppla, uppdatera och slå upp uppdragstagare.

8 endpoints på engelska

Utbetalningar

Skapa utbetalningar på samlingsfaktura och hämta status.

5 endpoints på engelska

Villkor

Gällande villkor och godkännande per uppdragstagare.

4 endpoints på engelska

Verifiering

Return-URL:er, verifieringssessioner och statusuppslagningar.

4 endpoints på engelska

Webhooks

employee.verified – utgående anrop när verifieringen är klar.

1 händelse på engelska

Hastighetsbegränsning

Autentiserad partnertrafik delar en rullande gräns per API-identitet: 500 begäranden per minut över alla /api/v1-rutter. Det finns inga egna gränser per endpoint – pollning, inloggningslänkar, villkorsuppdateringar och allt annat dras från samma budget.

429

Om gränsen överskrids svarar API:et 429 Too Many Requests. Svaret kan innehålla headern Retry-After med antalet sekunder tills du kan försöka igen. Lägg in exponentiell backoff i klienten och undvik att polla verifieringsstatus oftare än var 2:e–5:e sekund.

Behöver du hjälp?

Skicka ett e-postmeddelande till [email protected] med partnernamn och gärna verification_id eller användar-ID om frågan gäller en specifik uppdragstagare.

EasyFreelance Partner API