Pagination

Übersicht

Die LIVOI-API verwendet ein konsistentes Seitenmodell, um große Datenmengen kontrolliert abzurufen. Das page-Objekt steuert dabei eindeutig, welche Ausschnitte einer Datenliste übertragen werden.

• page gibt die Zielseite an (beginnend bei 1)
• size begrenzt die Elemente pro Seite
• Das Offset wird automatisch berechnet
• Die Response liefert Paging-Metadaten wie total und has_next

Anfragebeispiel

curl https://api.livoi.de/api/v1/dynamic/query \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "query_model": "user",
  "query_attributes": ["id", "email", "created_at"],
  "page": {
    "page": 1,
    "size": 10
  }
}'

Responseformat

{
  "result": [],
  "page": {
    "page": "1",
    "size": "10",
    "total": "42",
    "has_next": true
  }
}

Bedeutung der Paging-Parameter

page
Die aktuelle Seite der Ergebnismenge.

size
Maximale Anzahl von Einträgen pro Seite.

total

{ "formula": "total_pages = ceil(total / size)" }

has_next

{ "formula": "page * size < total" }

Offset-Berechnung

Offset = (page - 1) * size

Beispiel: page = 3, size = 10 → Offset = 20
Damit werden die Elemente 21–30 zurückgegeben.

Beispielseiten

{
  "page": "1",
  "size": "10",
  "total": "42",
  "has_next": true
}

{
  "page": "2",
  "size": "10",
  "total": "42",
  "has_next": true
}

{
  "page": "5",
  "size": "10",
  "total": "42",
  "has_next": false
}