Server et URLs

Tous les points de terminaison des API sont relatifs à l’URL de base https://api.auroravision.net/api/rest.
En fonction de l’API que vous souhaitez appeler, vous aurez une concaténation entre l’URL de base et les paramètres de chemin des points de terminaison dédiés à des ressources et services spécifiques.
Par exemple : en supposant que vous souhaitiez vous authentifier, l’API sera composée de l’URL de base https://api.auroravision.net/api/rest concaténé au point de terminaison exprimé avec le paramètre path /authenticate.

En général, il est toujours important de garder à l’esprit que toute API:

  • Path: parties variables d’un chemin d’URL utilisé pour pointer vers une ressource spécifique dans une collection;
  • Header: piloter les paramètres pour les requêtes HTTP qui sont nécessaires pour obtenir une réponse côté serveur;
  • Query: paramètres permettant de filtrer et de personnaliser l’appel API en les enchaînant avec une syntaxe spécifique, ils peuvent être obligatoires ou facultatifs;

Tout appel effectué via le service API a le X-AuroraVision-Token comme header.
Pour obtenir le jeton, vous devez utiliser le Authentication API en entrant les informations d’identification du compte Aurora Vision avec le X-AuroraVision-ApiKey comme header de l’appel.

Il est possible de visualiser toutes les API, avec une description de tous les paramètres, à travers la documentation appropriée (OpenAPIs Swagger).