Champ de l’API Links

Champ Links

Le champ Links fournit des chemins et des chaînes de requête pour vous permettre de naviguer dans des ensembles de résultats paginés.

Lorsque vous appelez l’endpoint d’une liste paginée, la réponse ne renvoie généralement que le premier lot de résultats (par exemple, les 100 premières lignes). Pour récupérer le lot suivant, utilisez l’objet Links : transmettez la valeur Links.Next dans la requête suivante.

Lorsque la réponse est paginée, l’objet Links inclut généralement :

• Self : chemin et requête pour la page en cours (le lot que vous venez de recevoir)
• Next : chemin et requête pour la page suivante (quand d’autres résultats existent) À la dernière page, Next est absent ou vide.

Exemple

Une réponse paginée inclut souvent les valeurs Data, Links et 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": "..."
  }
}

Pour récupérer la page suivante avec Links, envoyez une requête GET à l’URL de base, plus Links.Next (sans ajouter de slash entre l’hôte et le chemin) :

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

Pour naviguer sur une page avec un curseur, lisez notre article sur le champ Cursor.