# VirtualCar360 Img-Out API

VirtualCar360 API umożliwia integrację zdjęć pojazdów, galerii 360°, materiałów video, hotspotów oraz danych potrzebnych do prezentacji samochodów w systemach dealerskich, portalach ogłoszeniowych i własnych aplikacjach klienta.

API pozwala wyszukiwać galerie po numerze VIN, numerze rejestracyjnym albo identyfikatorze galerii, a następnie pobierać zestawy zdjęć, linki do materiałów video oraz dane dodatkowe wykorzystywane przez Player i Player 360.

Dostęp do API wymaga klucza API przekazywanego jako parametr query string `key`. W celu uzyskania dostępu lub konfiguracji klucza grupowego skontaktuj się z supportem VirtualCar360.

Version: v6.0

## Servers

Serwer produkcyjny
```
https://img-out.virtualcar360.pl
```

Serwer testowy / UAT
```
https://vc360-uat-imagein.azurewebsites.net
```

## Security

### ApiKeyQuery

Klucz API przypisany do konta, lokalizacji albo grupy kont VirtualCar360.

Type: apiKey
In: query
Name: key

## Download OpenAPI description

[VirtualCar360 Img-Out API](https://docs.virtualcar360.com/_bundle/api/openapi.yaml)

## Wyszukiwanie galerii

Wyszukiwanie galerii pojazdów po filtrach, takich jak VIN, numer rejestracyjny i zakres dat.

### Wyszukuje galerie po filtrach

 - [GET /api/v6.0/virtual-360/idsWithNames](https://docs.virtualcar360.com/api/openapi/wyszukiwanie-galerii/searchgalleries.md): Zwraca stronicowaną listę galerii pojazdów na podstawie filtrów. Endpoint może być używany do wyszukiwania galerii po dokładnym VIN, numerze rejestracyjnym, fragmentach tych wartości oraz zakresie dat utworzenia.

## Listowanie galerii

Pobieranie listy galerii przypisanych do pojazdu.

### Pobiera listę galerii po numerze rejestracyjnym

 - [GET /api/v6.0/virtual-360/list/numberplates/{numberplates}](https://docs.virtualcar360.com/api/openapi/listowanie-galerii/listgalleriesbynumberplates.md): Zwraca stronicowaną listę wszystkich galerii przypisanych do podanego numeru rejestracyjnego. Działa analogicznie do listowania po VIN.

### Pobiera listę galerii po numerze VIN

 - [GET /api/v6.0/virtual-360/list/vin/{vin}](https://docs.virtualcar360.com/api/openapi/listowanie-galerii/listgalleriesbyvin.md): Zwraca stronicowaną listę wszystkich galerii przypisanych do podanego numeru VIN. Jeden pojazd może posiadać wiele galerii wykonanych w różnym czasie albo w różnych standardach zdjęć.

## Najnowsza galeria

Pobieranie najnowszej galerii pojazdu po numerze VIN albo numerze rejestracyjnym.

### Pobiera najnowszą galerię po numerze rejestracyjnym

 - [GET /api/v6.0/virtual-360/numberplates/{numberplates}](https://docs.virtualcar360.com/api/openapi/najnowsza-galeria/getlatestgallerybynumberplates.md): Zwraca pojedynczy rekord najnowszej galerii powiązanej z podanym numerem rejestracyjnym. Użyj pola id z odpowiedzi jako carId w endpointcie /image-set.

### Pobiera najnowszą galerię po numerze VIN

 - [GET /api/v6.0/virtual-360/vin/{vin}](https://docs.virtualcar360.com/api/openapi/najnowsza-galeria/getlatestgallerybyvin.md): Zwraca pojedynczy rekord najnowszej galerii powiązanej z podanym numerem VIN. Użyj pola id z odpowiedzi jako carId w endpointcie /image-set.

## Zdjęcia

Pobieranie zestawów zdjęć, zdjęć 1080p, hotspotów i linków video dla galerii.

### Pobiera zestaw zdjęć galerii

 - [GET /api/v6.0/virtual-360/image-set](https://docs.virtualcar360.com/api/openapi/zdjecia/getimageset.md): Zwraca kompletny obiekt galerii wraz ze wszystkimi zestawami zdjęć, zdjęciami 1080p, informacją o filmach, hotspotami oraz danymi dodatkowymi. Jest to główny endpoint do pobierania gotowych URL-i zdjęć wykorzystywanych we własnych aplikacjach lub własnym widoku galerii.