inventory/get_groups.php
Zuletzt geändert von YellowFox_RD am 2025/03/04 16:25
Inhaltsverzeichnis
Diese Funktion liefert die Liste an Objektgruppen zurück. Jede Gruppe besteht aus einem Namen und einer UUID. Die Objektgruppen können vor allem in Verbindung mit den anderen objektspezifischen Funktionen verwendet werden, um die Ergebnismenge einzugrenzen.
Beschreibung
GET/inventory/get_groups.php?company=RTI_COMPANYKEY&import=IMPORTKEY
Parameter
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | |
| import | RTI Importschlüssel | string | ja | |
| offset | int | Pro Abfrage werden bis zu 1000 Einträge zurück geliefert. Um weitere Einträge zu erhalten, können Sie ein Offset angeben. | nein | |
| profiles[] | Profiles UUID | [] string | optionale Einschränkung auf eine Liste an Objektprofilen | nein |
| objects[] | Objects UUID | [] string | optionale Einschränkung auf eine Liste an Objekten | nein |
| groups[] | Gruppenname UUID | [] string | optionale Einschränkung auf eine Liste an Objektgruppen | nein |
| with_beacon | Beacon Positionsmeldungen | bool |
| nein |
Rückgabe
Bei Erfolg erhalten Sie die Rückgabe im JSON Format. Bei fehlenden Pflichtparametern oder Fehlern wird ein "ERROR:Beschreibung" zurückgegeben.
Mögliche Fehlerwerte
| Fehler | Beschreibung |
|---|---|
| MISSING_COMPANY | Firmenschlüssel fehlt |
| INVALID_COMPANY | Firma nicht gefunden. Dies kann an einem fehlerhaften Firmen- oder Import-Schlüssel liegen. |
| ERROR_MAINTENANCE | Ihre Firma wird gerade gewartet, währenddessen sind keine RTI Abfragen möglich. |
| MISSING_IMPORT | Import-Schlüssel fehlt. |
| INVENTORY_NOT_ACTIVATED | Objektverwaltung ist für ihre Firma nicht aktiviert. |
| INVALID_FORMAT_OFFSET | Offset ist falsch. |
JSON
Die genaue Spezifikation finden Sie anhand einer JSON Schema Datei hier.
Beispiel Ausgabe
{
"_date": "2025-02-26T10:22:37+01:00",
"_links": {
"next": {
"href": null
}
},
"groups": [
{
"uuid": "66ff7431-e455-7d1c-7a20-0ec6c464c80a",
"name": "Container Sachsen"
},
{
"uuid": "c1f91a2d-e867-f18d-f573-9219d66b8330",
"name": "Container NRW"
},
{
"uuid": "7d69b118-2174-df57-9ab2-574c251f5c8d",
"name": "Container Bayern"
}
]
}
"_date": "2025-02-26T10:22:37+01:00",
"_links": {
"next": {
"href": null
}
},
"groups": [
{
"uuid": "66ff7431-e455-7d1c-7a20-0ec6c464c80a",
"name": "Container Sachsen"
},
{
"uuid": "c1f91a2d-e867-f18d-f573-9219d66b8330",
"name": "Container NRW"
},
{
"uuid": "7d69b118-2174-df57-9ab2-574c251f5c8d",
"name": "Container Bayern"
}
]
}
Beispielaufrufe
https://map.yellowfox.de/rti/inventory/get_groups.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY