API/Paginering
Kom i gång
Paginering
Alla endpoints som returnerar listor använder samma pagineringsformat. Objekten ligger i results-fältet i svaret.
Frågeparametrar
| Fält | Typ | Beskrivning | |
|---|---|---|---|
page | integer | valfri | Vilken sida som ska hämtas. Standard 1. |
page_size | integer | valfri | Antal objekt per sida. Standard 25. |
Svarsformat
| Fält | Typ | Beskrivning |
|---|---|---|
total | integer | Totalt antal objekt som matchar sökningen. |
count | integer | Antal objekt i results på den här sidan. |
next | string / null | Fullständig URL till nästa sida, eller null på sista sidan. |
previous | string / null | Fullständig URL till föregående sida, eller null på första sidan. |
results | array | Själva objekten. |
{
"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"] }
}
]
}Vilka endpoints
| Endpoint | Returnerar |
|---|---|
GET /users | Uppdragstagare kopplade till partnern. |
GET /payouts | Utbetalningar för alla uppdragstagare. |
GET /users/{id}/payouts | Utbetalningar för en enskild uppdragstagare. |
Praktiska råd
- Följ
nexttills den ärnulli stället för att räkna ut sidnummer själv – då klarar integrationen att objekt tillkommer under tiden. - Kom ihåg att varje sida är ett eget anrop mot hastighetsbudgeten på 500 begäranden per minut. Hämta hellre större sidor än att paginera i små steg.
GET /payoutsochGET /users/{id}/payoutstar ocksåstatussom filter (exakt träff), så att du slipper hämta allt.