Wiki-Quellcode von inventory/get_groups.php
Version 1.1 von Dominic Lippmann am 2025/03/04 16:18
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% class="box" %) | ||
| 2 | (((Inhaltsverzeichnis))) | ||
| 3 | {{toc/}} | ||
| 4 | |||
| 5 | 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. | ||
| 6 | = Beschreibung = | ||
| 7 | //**GET **////**/inventory/get_groups.php?company**=RTI_COMPANYKEY**&import**=IMPORTKEY// | ||
| 8 | = Parameter = | ||
| 9 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
| 10 | |company|RTI Firmenschlüssel|string||ja | ||
| 11 | |import|RTI Importschlüssel|string||ja | ||
| 12 | |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 | ||
| 13 | |profiles[]|Profiles UUID|[] string|optionale Einschränkung auf eine Liste an Objektprofilen|nein | ||
| 14 | |objects[]|Objects UUID|[] string|optionale Einschränkung auf eine Liste an Objekten|nein | ||
| 15 | |groups[]|Gruppenname UUID|[] string|optionale Einschränkung auf eine Liste an Objektgruppen|nein | ||
| 16 | |with_beacon|Beacon Positionsmeldungen|bool| ((( | ||
| 17 | * false: der letzte Status wird nur anhand der gebuchten Aktivitäten zurückgegeben | ||
| 18 | * true: Als Zeitpunkt des letzten Status werden auch Beacon-Positionsmeldungen beachtet. | ||
| 19 | )))|nein | ||
| 20 | |||
| 21 | = Rückgabe = | ||
| 22 | Bei Erfolg erhalten Sie die Rückgabe im JSON Format. Bei fehlenden Pflichtparametern oder Fehlern wird ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben. | ||
| 23 | |||
| 24 | == Mögliche Fehlerwerte == | ||
| 25 | |=Fehler|=Beschreibung | ||
| 26 | |MISSING_COMPANY|Firmenschlüssel fehlt | ||
| 27 | |INVALID_COMPANY|Firma nicht gefunden. Dies kann an einem fehlerhaften Firmen- oder Import-Schlüssel liegen. | ||
| 28 | |ERROR_MAINTENANCE|Ihre Firma wird gerade gewartet, währenddessen sind keine RTI Abfragen möglich. | ||
| 29 | |MISSING_IMPORT|Import-Schlüssel fehlt. | ||
| 30 | |INVENTORY_NOT_ACTIVATED|Objektverwaltung ist für ihre Firma nicht aktiviert. | ||
| 31 | |INVALID_FORMAT_OFFSET|Offset ist falsch. | ||
| 32 | |||
| 33 | == JSON == | ||
| 34 | Die genaue Spezifikation finden Sie anhand einer JSON Schema Datei [[hier>>https://map.yellowfox.de/rti/schema/get_groups_schema.json]]. | ||
| 35 | |||
| 36 | **Beispiel Ausgabe** | ||
| 37 | |||
| 38 | {{code language="js"}}{ | ||
| 39 | "_date": "2025-02-26T10:22:37+01:00", | ||
| 40 | "_links": { | ||
| 41 | "next": { | ||
| 42 | "href": null | ||
| 43 | } | ||
| 44 | }, | ||
| 45 | "groups": [ | ||
| 46 | { | ||
| 47 | "uuid": "66ff7431-e455-7d1c-7a20-0ec6c464c80a", | ||
| 48 | "name": "Container Sachsen" | ||
| 49 | }, | ||
| 50 | { | ||
| 51 | "uuid": "c1f91a2d-e867-f18d-f573-9219d66b8330", | ||
| 52 | "name": "Container NRW" | ||
| 53 | }, | ||
| 54 | { | ||
| 55 | "uuid": "7d69b118-2174-df57-9ab2-574c251f5c8d", | ||
| 56 | "name": "Container Bayern" | ||
| 57 | } | ||
| 58 | ] | ||
| 59 | }{{/code}} | ||
| 60 | |||
| 61 | = Beispielaufrufe = | ||
| 62 | {{code language="java"}}https://map.yellowfox.de/rti/inventory/get_groups.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY{{/code}} |