RIP-Konfigurationsdatei hinzufügen/aktualisieren
RIP-Konfigurationen sind mit einem bestimmten Computer verbunden, der durch seine ComputerGUID identifiziert wird. Wenn eine RIP-Konfigurationsdatei mit dem ComputerGUID gefunden wird, wird die RIP-Konfigurationsdatei aktualisiert, andernfalls wird eine neue RIP-Konfigurationsdatei hinzugefügt.
URL:
POST http://api.aurelon.com/api/v2/
Konfiguration
Kopfzeilen anfordern:
Inhalt-Typ : multipart/form-data
HardwareHash : siehe Authentifizierung
SerienNummer : siehe Authentifizierung
AnwendungsVersion : siehe Authentifizierung
Anfrage Körper:
Formulardaten 1: erforderlich
-
- Name: JsonString
- Inhalt-Typ: application/json
- {„ComputerGUID“:“00000000-0000-0000-0000-000000000000″} Die GUID des RIP-Computers wird als ComputerGUID übergeben
Formulardaten 2: erforderlich
-
- Name: RIP.xml (das Element der Eingabedatei kann einen beliebigen Namen haben)
- Inhalt-Typ: application/xml
- Die XML-Datei der Konfiguration
Antwort:
Der Inhaltstyp der Antwort ist im JSON-Format
Erfolg:
- 200 OK : „Konfiguration erfolgreich hinzugefügt“
Fehler:
- 401 Nicht autorisiert : {„Meldung“: „Ungültiger HardwareHash“}
- 415 Nicht unterstützter Medientyp : {„Message“: „Diese Anfrage ist nicht richtig formatiert“}
- 401 Nicht autorisiert : {„Meldung“: „“HardwareHash“, „SerialNumber“ und „ApplicationVersion“ header are required“}
- 400 Schlechte Anfrage : {„Message“:““ComputerGUID“ erforderlich“}
- 400 Bad Request : {„Message“: „Validierung der ComputerGUID fehlgeschlagen“}
- 500 Interner Serverfehler : {„Meldung“: „Interner Serverfehler“}
Beispiel einer XML-Konfigurationsdatei:
hier
Konfiguration abrufen
Lädt die RIP-Konfigurationsdatei mit ComputerGUID falls gefunden.
URL:
GET http://api.aurelon.com/api/v2/
Konfiguration/<ComputerGUID>
Kopfzeilen anfordern:
MisKey : siehe Authentifizierung
HardwareHash : siehe Authentifizierung
SerienNummer : siehe Authentifizierung
AnwendungsVersion : siehe Authentifizierung
Antwort:
Der Inhaltstyp ist application/xml und enthält den XML-Code für die Konfiguration des RIP-Computers. Oder der Inhaltstyp application/json, wenn es sich um einen Fehlerinhalt handelt.
Erfolg:
- 200 OK : Konfiguration XML
Fehler:
- 401 Nicht autorisiert : {„Nachricht“: „Ungültiger MisKey“}
- 401 Nicht autorisiert : {„Message“:““HardwareHash“-Header ist ungültig“}
- 404 Nicht gefunden : {„Meldung“: „ComputerGUID nicht gefunden“}
- 401 Nicht autorisiert : {„Meldung“: „“MisKey“ oder „HardwareHash“, „SerialNumber“ und „ApplicationVersion“ header are required“}
- 500 Interner Serverfehler : {„Meldung“: „Interner Serverfehler“}
Standortliste abrufen
Empfängt eine Liste aktiver Standorte, die durch ihre Seriennummer identifiziert werden
URL:
GET http://api.aurelon.com/
api/v2/konfiguration/sites
Kopfzeilen anfordern:
MisKey : siehe Authentifizierung
HardwareHash : siehe Authentifizierung
SerienNummer : siehe Authentifizierung
AnwendungsVersion : siehe Authentifizierung
Antwort:
Inhaltstyp application/json und enthält das JSON der durch die Seriennummer identifizierten bekannten Standorte.
Erfolg:
- 200 OK : Array von Websites
Ex:
[{
„SiteGUID“:“8447e5b0-99ac-11e7-a2d0-215af4f8ef85″,
„SerialNumber“:333674,
„Standort“:null,
}, {
…
}]
Fehler:
- 401 Nicht autorisiert : {„Nachricht“: „Ungültiger MisKey“}
- 401 Nicht autorisiert : {„Meldung“: „Ungültiger HardwareHash“}
- 401 Nicht autorisiert : {„Meldung“: „“MisKey“ oder „HardwareHash“, „SerialNumber“ und „ApplicationVersion“ header are required“}
- 500 Interner Serverfehler : {„Meldung“: „Interner Serverfehler“}
Standortkonfiguration abrufen
Empfängt die Liste der aktiven Geräte/Warteschlangen und RIPs mit der Seriennummer
URL:
GET http://api.aurelon.com/
api/v2/konfiguration/site/<SerienNummer>
Kopfzeilen anfordern:
MisKey : siehe Authentifizierung
HardwareHash : siehe Authentifizierung
SerienNummer : siehe Authentifizierung
AnwendungsVersion : siehe Authentifizierung
Antwort:
Inhaltstyp application/json und enthält das JSON der bekannten Konfigurationen an dem durch die Seriennummer identifizierten Standort.
Erfolg:
- 200 OK : Reihe von Computern, ihren Geräten und deren Warteschlangen.
Ex:
[{
„ComputerGUID“:“8447e5b0-99ac-11e7-a2d0-215af4f8ef85″,
„Name“: „myrip.company.domain“,
„Modified“:“2018-06-27T07:56:36Z“,
„Geräte“:[{
„DeviceGUID“:“6da06b44-20ee-11e6-b287-07f164aa386e“,
„Name“: „Durst Rhotex 322“,
„Modified“:“2018-06-27T07:56:36Z“,
„DriverID“:1601
}, {
…
}]
}, {
…
}]
Fehler:
- 401 Nicht autorisiert : {„Nachricht“: „Ungültiger MisKey“}
- 401 Nicht autorisiert : {„Meldung“: „Ungültiger HardwareHash“}
- 404 Nicht gefunden : {„Message“: „SerialNumber not found“}
- 401 Nicht autorisiert : {„Meldung“: „“MisKey“ oder „HardwareHash“, „SerialNumber“ und „ApplicationVersion“ header are required“}
- 500 Interner Serverfehler : {„Meldung“: „Interner Serverfehler“}
Konfiguration Sync
Aktualisierung der Liste der aktiven Geräte/Warteschlangen in einem RIP
URL:
POST http://api.aurelon.com/
api/v2/konfiguration/sync
Kopfzeilen anfordern:
Inhalt-Typ : application/json
HardwareHash : siehe Authentifizierung
SerienNummer : siehe Authentifizierung
AnwendungsVersion : siehe Authentifizierung
Anfrage Körper:
JSON-Objekt enthält:
- ComputerGUID – erforderlich – die Computer-GUID
- GeräteListe – required – Array von Objekten pro Gerät. Jedes Objekt enthält:
- DeviceGUID – erforderlich – aktive Geräte-GUIDs im RIP
- QueueList – Array aktiver Warteschlangen-GUIDs beim RIP
Antwort:
Inhaltstyp application/json, der das Ergebnis der Operation enthält.
Erfolg:
- 200 OK : „Konfiguration erfolgreich gespeichert“
Fehler:
- 401 Nicht autorisiert : {„Meldung“: „Ungültiger HardwareHash“}
- 415 Nicht unterstützter Medientyp : {„Message“: „Diese Anfrage ist nicht richtig formatiert“}
- 401 Nicht autorisiert : {„Meldung“: „“HardwareHash“, „SerialNumber“ und „ApplicationVersion“ header are required“}
- 400 Bad Request : {„Message“:““ComputerGUID“ erforderlich“}
- 400 Bad Request : {„Message“:““DeviceList“-Feld ist erforderlich“}
- 400 Bad Request : {„Message“:““QueueList“-Feld ist erforderlich“}
- 500 Interner Serverfehler : {„Meldung“: „Interner Serverfehler“}
RIP hinzufügen/aktualisieren
Wenn ein RIP mit ComputerGUID gefunden wird, wird das RIP aktualisiert, andernfalls wird ein neues RIP hinzugefügt.
URL:
POST http://api.aurelon.com/
api/v2/konfiguration/rip
Kopfzeilen anfordern:
Inhalt-Typ : application/json
HardwareHash : siehe Authentifizierung
SerienNummer : siehe Authentifizierung
AnwendungsVersion : siehe Authentifizierung
Anfrage Körper:
JSON-Objekt enthält:
- ComputerGUID – erforderlich – die Computer-GUID
- ComputerName – Name des Computers oder DNS-Name
- OperatingSystem – Typ und Version des Betriebssystems
Antwort:
Inhaltstyp application/json, der das Ergebnis der Operation enthält.
Erfolg:
- 200 OK : „Computerdetails erfolgreich gespeichert“
Fehler:
- 401 Nicht autorisiert : {„Meldung“: „Ungültiger HardwareHash“}
- 415 Nicht unterstützter Medientyp : {„Message“: „Erwarteter Typ: application/json“}
- 401 Nicht autorisiert : {„Meldung“: „“HardwareHash“, „SerialNumber“ und „ApplicationVersion“ header are required“}
- 400 Bad Request : {„Message“:““ComputerGUID“ erforderlich“}
- 500 Interner Serverfehler : {„Meldung“: „Interner Serverfehler“}
Gerät hinzufügen/aktualisieren
Wenn ein Gerät mit GeräteGUID gefunden wird, wird das Gerät aktualisiert, andernfalls wird ein neues Gerät hinzugefügt, wenn es Teil der Lizenz ist. Wenn die DeviceGUID nicht Teil der Lizenz ist, wird ein Fehler zurückgegeben.
URL:
POST http://api.aurelon.com/
api/v2/konfiguration/geraet
Kopfzeilen anfordern:
Inhalt-Typ : application/json
MisKey : siehe Authentifizierung
HardwareHash : siehe Authentifizierung
SerienNummer : siehe Authentifizierung
AnwendungsVersion : siehe Authentifizierung
Anfrage Körper:
JSON-Objekt enthält:
- DeviceGUID – erforderlich – die Geräte-GUID
- ComputerGUID – erforderlich – das RIP, auf dem dieses Gerät installiert ist
- Name
- Typ
- MediaType
- MediaSize
- MediaSource
- Hersteller
- Modell
- DriverID (eindeutige Fahrer-ID aus der HUB-Datenbank)
- Verbindungs-URI
Antwort:
Inhaltstyp application/json, der das Ergebnis der Operation enthält.
Erfolg:
- 200 OK : „Gerät erfolgreich gespeichert“
Fehler:
- 401 Nicht autorisiert : {„Meldung“: „Ungültiger HardwareHash“}
- 401 Nicht autorisiert : {„Message“: „Ungültiger MisKey“}
- 404 Nicht gefunden : {„Meldung“: „DeviceGUID wird nicht gefunden“}
- 415 Nicht unterstützter Medientyp : {„Message“: „Diese Anfrage ist nicht richtig formatiert“}
- 401 Nicht autorisiert : {„Meldung“: „“MisKey“ oder „HardwareHash“, „SerialNumber“ und „ApplicationVersion“ header are required“}
- 400 Bad Request : {„Message“:““DeviceGUID“ erforderlich“}
- 400 Bad Request : {„Message“:““ComputerGUID“ erforderlich“}
- 500 Interner Serverfehler : {„Meldung“: „Interner Serverfehler“}
Warteschlange hinzufügen/aktualisieren
Wenn eine Warteschlange mit QueueGUID gefunden wird, wird die Warteschlange aktualisiert, andernfalls wird eine neue Warteschlange hinzugefügt.
URL:
POST http://api.aurelon.com/
api/v2/konfiguration/warteschlange
Kopfzeilen anfordern:
Inhalt-Typ : application/json
MisKey : siehe Authentifizierung
HardwareHash : siehe Authentifizierung
SerienNummer : siehe Authentifizierung
AnwendungsVersion : siehe Authentifizierung
Anfrage Körper:
JSON-Objekt enthält:
- QueueGUID – erforderlich – die GUID der Warteschlange
- DeviceGUID – erforderlich
- Profilname
- Name
- MediaType
- MediaSize
- MediaSource
- QueueType
- DriverSettings
Antwort:
Inhaltstyp application/json, der das Ergebnis der Operation enthält.
Erfolg:
- 200 OK : „Warteschlange erfolgreich gespeichert“
Fehler:
- 401 Nicht autorisiert : {„Meldung“: „Ungültiger HardwareHash“}
- 401 Nicht autorisiert : {„Message“: „Ungültiger MisKey“}
- 404 Nicht gefunden : {„Meldung“: „DeviceGUID wird nicht gefunden“}
- 415 Nicht unterstützter Medientyp : {„Message“: „Erwarteter Typ: application/json“}
- 401 Nicht autorisiert : {„Meldung“: „“MisKey“ oder „HardwareHash“, „SerialNumber“ und „ApplicationVersion“ header are required“}
- 400 Bad Request : {„Message“:““DeviceGUID“ erforderlich“}
- 400 Bad Request : {„Message“:““QueueGUID“ erforderlich“}
- 500 Interner Serverfehler : {„Meldung“: „Interner Serverfehler“}
Gerät löschen
Löscht das angegebene Gerät.
URL:
DELETE http://api.aurelon.com/
api/v2/konfiguration/device/<DeviceGUID>
Kopfzeilen anfordern:
Inhalt-Typ : application/json
MisKey : siehe Authentifizierung
HardwareHash : siehe Authentifizierung
SerienNummer : siehe Authentifizierung
AnwendungsVersion : siehe Authentifizierung
Antwort:
Inhaltstyp application/json, der das Ergebnis der Operation enthält.
Erfolg:
- 200 OK : „Gerät erfolgreich gelöscht“
Fehler:
- 401 Nicht autorisiert : {„Meldung“: „Ungültiger HardwareHash“}
- 401 Nicht autorisiert : {„Message“: „Ungültiger MisKey“}
- 404 Nicht gefunden : {„Meldung“: „DeviceGUID wird nicht gefunden“}
- 401 Nicht autorisiert : {„Meldung“: „“MisKey“ oder „HardwareHash“, „SerialNumber“ und „ApplicationVersion“ header are required“}
- 400 Bad Request : {„Message“:““DeviceGUID“ Wert erforderlich“}
- 500 Interner Serverfehler : {„Meldung“: „Interner Serverfehler“}
Warteschlange löschen
Löscht die angegebene Warteschlange.
URL:
DELETE http://api.aurelon.com/
api/v2/konfiguration/queue/<QueueGUID>
Kopfzeilen anfordern:
Inhalt-Typ : application/json
MisKey : siehe Authentifizierung
HardwareHash : siehe Authentifizierung
SerienNummer : siehe Authentifizierung
AnwendungsVersion : siehe Authentifizierung
Antwort:
Inhaltstyp application/json, der das Ergebnis der Operation enthält.
Erfolg:
- 200 OK : „Gerät erfolgreich gelöscht“
Fehler:
- 401 Nicht autorisiert : {„Meldung“: „Ungültiger HardwareHash“}
- 401 Nicht autorisiert : {„Message“: „Ungültiger MisKey“}
- 404 Nicht gefunden : {„Message“: „QueueGUID wird nicht gefunden“}
- 401 Nicht autorisiert : {„Meldung“: „“MisKey“ oder „HardwareHash“, „SerialNumber“ und „ApplicationVersion“ header are required“}
- 400 Bad Request : {„Message“:““QueueGUID“ Wert erforderlich“}
- 500 Interner Serverfehler : {„Meldung“: „Interner Serverfehler“}