Server und URLs
TAlle API-Endpunkte sind relativ zur Basis-URL https://api.auroravision.net/api/rest
.
Basierend auf der API, die Sie aufrufen möchten, haben Sie eine Verkettung zwischen der Basis-URL und den Pfadparametern, die Endpunkte aufrufen, die bestimmten Ressourcen und Diensten zugeordnet sind.
Angenommen, Sie möchten sich beispielsweise authentifizieren, besteht die API aus der basis https://api.auroravision.net/api/rest
mit dem Endpunkt verkettet, der mit dem Pfadparameter ausgedrückt wird /authenticate
.
Es ist immer wichtig zu bedenken, dass jede API immer aus verschiedenen Parametern bestehen wird:
Path
: teile eines URL-Pfads, die verwendet werden, um auf eine bestimmte Ressource innerhalb einer Sammlung zu verweisen, sind sie immer erforderlich;Header
: treiberparameter für die HTTP-Anfrage, sie sind erforderlich, um eine serverseitige Antwort zu erhalten;Query
: können erforderlich und optional sein, sie werden verwendet, um den API-Aufruf zu filtern und anzupassen, indem sie mit einer bestimmten Syntax verkettet werden;
Jeder Aufruf, der über den APIs-Dienst getätigt wird, hat die X-AuroraVision-Token
als seine header.
Um das Token zu erhalten, müssen Sie die verwenden Authentication
API indem Sie die Anmeldeinformationen für das Aurora Vision-Konto zusammen mit dem eingeben X-AuroraVision-ApiKey
als header
des aufrufs.
Es ist möglich, alle APIs mit einer Beschreibung der Parameter über die entsprechende Dokumentation anzuzeigen (OpenAPIs Swagger).