Serwer i URLs
Wszystkie punkty końcowe interfejsów API są względne w stosunku do podstawowego adresu URL https://api.auroravision.net/api/rest
.
W oparciu o interfejs API, który chcesz wywołać, będziesz mieć połączenie między podstawowym adresem URL a parametrami ścieżki, które wywołują punkty końcowe przeznaczone dla określonych zasobów i usług.
Na przykład zakładając, że chcesz uwierzytelnić, interfejs API będzie składał się z podstawowego adresu URL https://api.auroravision.net/api/rest
połączonego z punktem końcowym wyrażonym za pomocą parametru ścieżki /authenticate
.
Należy zawsze pamiętać, że każdy interfejs API zawsze będzie składał się z różnych parametrów:
Path
: zmienne części ścieżki URL używane do wskazywania określonego zasobu w kolekcji, zawsze są wymagane;Header
: parametr sterujący dla żądania HTTP, są wymagane do uzyskania odpowiedzi po stronie serwera;Query
: może być wymagane i opcjonalne, służą one do filtrowania i dostosowywania wywołania API poprzez łączenie ich z określoną składnią;
Każde wywołanie wykonane za pośrednictwem usługi API ma nagłówek X-AuroraVision-Token
.
Aby uzyskać token, musisz użyć interfejsu API Uwierzytelniania
, wprowadzając poświadczenia konta Aurora Vision i wraz z X-AuroraVision-ApiKey
jako header
wywołania.
Możliwe jest przeglądanie wszystkich API, wraz z opisem parametrów, poprzez odpowiednią dokumentację (OpenAPIs Swagger).