Konfiguration

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“}

 

Updated on Mai 10, 2022

Was this article helpful?