Beziehungen
Das API-Feld Relationships liefert Informationen dazu, wie die aktuelle Ressource mit anderen Ressourcen in der API verknüpft ist. Das Feld erscheint in API-Antworten und ermöglicht, zu zugehörigen Datenobjekten zu navigieren. Es enthält eine Reihe an Relationship-Objekten, jedes mit der folgenden Struktur:
| Feldname | Beschreibung |
|---|---|
Id |
Die einzigartige Kennung der zugehörigen Ressource. |
Type |
Der Ressourcentyp des zugehörigen Objekts. Zum Beispiel Monitor und MonitorCheck. |
Links |
Enthält URLs zu zugehörigen Ressourcen, die mit dem aktuellen Objekt verbunden sind. Dies enthält Self, was die direkte API-Endpunkt-URL ist, um auf die zugehörige Ressource zuzugreifen. Zum Beispiel /Monitor/6f426452-5d2b-4fdf-84e2-c2b3d7ebf918 kann in einer GET-Abfrage verwendet werden, um Daten dieses bestimmten Prüfobjekts abzurufen. |
API-Antwort
Wenn du Daten über die API abrufst, enthält die Antwort ein Relationships-Feld, das das verbundene Prüfobjekt zeigt:
{
...
"Relationships": [
{
"Id": "6f426452-5d2b-4fdf-84e2-c2b3d7ebf918",
"Type": "Monitor",
"Links": {
"Self": "/Monitor/6f426452-5d2b-4fdf-84e2-c2b3d7ebf918"
}
}
]
}
Relationships verwenden
Um die zugehörigen Prüfobjektdaten abzurufen, nutze die URL von Links.Self in einer neuen API-Abfrage:
GET https://api.uptrends.com/v4/Monitor/6f426452-5d2b-4fdf-84e2-c2b3d7ebf918
Dies gibt die vollständige Prüfobjektkonfiguration und mit den Originaldaten verbundene Details wieder.