API-Feld Links

Links

Das Feld Links bietet Pfad- und Abfrage-Strings, sodass du durch paginierte Ergebnissets navigieren kannst.

Wenn du einen paginierten Listen-Endpunkt aufrufst, gibt die Antwort in der Regel nur den ersten Stapel an Ergebnissen zurück (zum Beispiel die ersten 100 Zeilen). Um den nächsten Stapel abzurufen, kannst du das Links-Objekt nutzen: Folge Links.Next bei der folgenden Anfrage.

Wenn die Antwort paginiert ist, enthält das Links-Objekt häufig:

• Self – Pfad und Abfrage für die aktuelle Seite (den Ergebnisstapel, den du gerade erhalten hast).
• Next – Pfad und Abfrage für die nächste Seite, wenn weitere Ergebnisse vorhanden sind. Auf der letzten Seite wird Next ausgelassen oder ist leer.

Beispiel

Eine paginierte Antwort enthält häufig Data, Links und Cursors:

{
  "Data": [ ... ],
  "Links": {
    "Next": "/v4/MonitorCheck?Sorting=Descending&Take=100&PresetPeriod=Last24Hours&cursor=r%2b3aDoQMmmzQyn0gZpXRtuTPR9I1p481%2frdq5beRRu9fkwFNbL7g9EqtBTezyrx3cBfwgrEE8eSDh3WpqRTQEg%3d%3d",
    "Self": "/v4/MonitorCheck?Sorting=Descending&Take=100&PresetPeriod=Last24Hours&cursor=Waul03CKWbe9wj%2fZ%2fs%2fYHhAtN5gst9iN3oZ6yP4JvGxZrwiTWxY13mhIivXfKkwKNgN0sY66uVfczabtWzrQMQ%3d%3d"
  },
  "Cursors": {
    "Self": "...",
    "Next": "..."
  }
}

Um die nächste Seite mit Links abzurufen, sende eine GET-Abfrage an die Basis-URL plus Links.Next (kein extra Schrägstrich zwischen dem Host und dem Pfad):

GET https://api.uptrends.com/v4/MonitorCheck?Sorting=Descending&Take=100&PresetPeriod=Last24Hours&cursor=r%2b3aDoQMmmzQyn0gZpXRtuTPR9I1p481%2frdq5beRRu9fkwFNbL7g9EqtBTezyrx3cBfwgrEE8eSDh3WpqRTQEg%3d%3d

Weitere Infos, um zu einer Seite mit dem Cursor zu navigieren, findest du im Knowledge-Base-Artikel Cursor.