API/Paginering
Kom i gang
Paginering
Alle endepunkter som returnerer lister bruker samme pagineringsformat. Objektene ligger i results-feltet i responsen.
Spørringsparametre
| Felt | Type | Beskrivelse | |
|---|---|---|---|
page | integer | valgfri | Hvilken side som skal hentes. Standard 1. |
page_size | integer | valgfri | Antall objekter per side. Standard 25. |
Responsformat
| Felt | Type | Beskrivelse |
|---|---|---|
total | integer | Totalt antall objekter som matcher spørringen. |
count | integer | Antall objekter i results på denne siden. |
next | string / null | Full URL til neste side, eller null på siste side. |
previous | string / null | Full URL til forrige side, eller null på første side. |
results | array | Selve objektene. |
{
"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
| Endepunkt | Returnerer |
|---|---|
GET /users | Oppdragstakere koblet til partneren. |
GET /payouts | Utbetalinger for alle oppdragstakere. |
GET /users/{id}/payouts | Utbetalinger for én oppdragstaker. |
Praktiske råd
- Følg
nexttil den ernulli 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 /payoutsogGET /users/{id}/payoutstar ogsåstatussom filter (eksakt treff), slik at du slipper å hente alt.