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

API/Paginering

Kom i gang

Paginering

Alle endepunkter som returnerer lister bruker samme pagineringsformat. Objektene ligger i results-feltet i responsen.

Innhold

Spørringsparametre

FeltTypeBeskrivelse
pageintegervalgfriHvilken side som skal hentes. Standard 1.
page_sizeintegervalgfriAntall objekter per side. Standard 25.

Responsformat

FeltTypeBeskrivelse
totalintegerTotalt antall objekter som matcher spørringen.
countintegerAntall objekter i results på denne siden.
nextstring / nullFull URL til neste side, eller null på siste side.
previousstring / nullFull URL til forrige side, eller null på første side.
resultsarraySelve objektene.
GET /users?page=1&page_size=2
{
  "total": 148,
  "next": "https://app.easyfreelance.no/api/v1/users?page=2&page_size=2",
  "previous": null,
  "count": 2,
  "results": [
    {
      "id": 123,
      "email": "[email protected]",
      "internal_id": 456,
      "name": "Marte Hansen",
      "onboarding": { "is_onboarded": true, "missing_steps": [] }
    },
    {
      "id": 124,
      "email": "[email protected]",
      "internal_id": null,
      "name": "Jonas Skoglund",
      "onboarding": { "is_onboarded": false, "missing_steps": ["bank_account"] }
    }
  ]
}

Hvilke endepunkter

EndepunktReturnerer
GET /usersOppdragstakere koblet til partneren.
GET /payoutsUtbetalinger for alle oppdragstakere.
GET /users/{id}/payoutsUtbetalinger for én oppdragstaker.

Praktiske råd

  • Følg next til den er null i stedet for å regne ut sidetall selv – da tåler integrasjonen at objekter kommer til underveis.
  • Husk at hver side er et eget kall mot ratebudsjettet på 500 forespørsler i minuttet. Hent heller større sider enn å paginere i små steg.
  • GET /payouts og GET /users/{id}/payouts tar også status som filter (eksakt treff), slik at du slipper å hente alt.