{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"API","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"api","__idx":0},"children":["API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["VirtualCar360 API umożliwia pobieranie danych galerii pojazdów, zestawów zdjęć, hotspotów oraz linków do materiałów video. API jest przeznaczone dla integracji, które chcą samodzielnie wykorzystać dane VirtualCar360 we własnej stronie internetowej, systemie CRM, systemie administracyjnym, portalu ogłoszeniowym albo narzędziu dealerskim."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API może być używane między innymi do:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["budowania listingów ofert,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["pobierania zdjęć pojazdów do własnej strony internetowej,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["archiwizacji zdjęć samochodów,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["importowania danych galerii do własnych systemów administracyjnych,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["integracji z systemami CRM lub DMS,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["zasilania systemów takich jak WebWizard lub inne narzędzia klienta,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["pobierania linków do materiałów video,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["pobierania hotspotów i zdjęć dodatkowych,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["budowania własnego interfejsu galerii pojazdu."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Wskazówka"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Jeżeli chcesz tylko osadzić gotową prezentację pojazdu, użyj Playera. Jeżeli chcesz samodzielnie pobrać zdjęcia i zbudować własny widok, użyj API."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"base-url","__idx":1},"children":["Base URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adres produkcyjny API:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"txt","header":{"controls":{"copy":{}}},"source":"https://img-out.virtualcar360.pl/api/v6.0/virtual-360\n","lang":"txt"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wszystkie endpointy opisane w tej sekcji znajdują się pod powyższym adresem bazowym."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"autoryzacja","__idx":2},"children":["Autoryzacja"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dostęp do API wymaga przekazania klucza API w parametrze query string ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["key"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"txt","header":{"controls":{"copy":{}}},"source":"https://img-out.virtualcar360.pl/api/v6.0/virtual-360/vin/WBA1234567890?key=TWOJ_KLUCZ_API\n","lang":"txt"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Klucz API może być przypisany do jednej lokalizacji albo do wielu lokalizacji w formie klucza grupowego. Szczegóły znajdują się w sekcji ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Authorization"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Bezpieczeństwo"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["W przypadku bezpośrednich zapytań do API nie zaleca się umieszczania klucza API w kodzie frontendowym. Najbezpieczniejszy model integracji to backend proxy po stronie klienta."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"najważniejsze-pojęcia","__idx":3},"children":["Najważniejsze pojęcia"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"galeria","__idx":4},"children":["Galeria"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Galeria reprezentuje sesję zdjęciową pojazdu. Jeden pojazd może posiadać więcej niż jedną galerię, na przykład wykonaną w różnym czasie albo w różnym standardzie zdjęć."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Podstawowy rekord galerii zawiera między innymi:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vin"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numberPlates"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pole ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," jest szczególnie ważne, ponieważ służy jako ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carId"]}," w endpoincie ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/image-set"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"zestaw-zdjęć","__idx":5},"children":["Zestaw zdjęć"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Zestaw zdjęć to kompletny zestaw zdjęć galerii. Endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/image-set"]}," zwraca dane potrzebne do zbudowania własnego widoku galerii, w tym:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["zestawy zdjęć,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["zdjęcia 1080p, jeżeli są dostępne,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["hotspoty,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dane video,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dane inspekcji, jeżeli są dostępne,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["metadane pojazdu i galerii."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"hotspot","__idx":6},"children":["Hotspot"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Hotspot to oznaczony punkt na zdjęciu pojazdu. Może wskazywać konkretny element, na przykład reflektor, felgę, rysę albo uszkodzenie. Hotspot może posiadać zdjęcia dodatkowe pokazujące wskazany element w większym zbliżeniu."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"video","__idx":7},"children":["Video"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Jeżeli dla galerii dostępny jest materiał video, API może zwrócić pole ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["video"]},". W obecnym modelu pole ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["video"]}," może być stringiem zawierającym JSON z linkami do platform takich jak Vimeo lub YouTube."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpointy","__idx":8},"children":["Endpointy"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Metoda"},"children":["Metoda"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Opis"},"children":["Opis"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/vin/{vin}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pobiera najnowszą galerię po numerze VIN."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/numberplates/{numberplates}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pobiera najnowszą galerię po numerze rejestracyjnym."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/list/vin/{vin}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pobiera listę galerii przypisanych do numeru VIN."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/list/numberplates/{numberplates}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pobiera listę galerii przypisanych do numeru rejestracyjnego."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/image-set"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pobiera kompletny zestaw zdjęć, hotspoty i dane video dla galerii."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/idsWithNames"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wyszukuje galerie po filtrach, takich jak VIN, numer rejestracyjny i zakres dat."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/add-announcement"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dodaje ogłoszenie do systemu VirtualCar360. Endpoint przeznaczony dla integracji eksportujących dane."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"podział-endpointów-w-api-reference","__idx":9},"children":["Podział endpointów w API Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["W pliku OpenAPI endpointy są pogrupowane zgodnie z układem dokumentacji:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Sekcja API Reference"},"children":["Sekcja API Reference"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpointy"},"children":["Endpointy"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Zastosowanie"},"children":["Zastosowanie"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Wyszukiwanie galerii"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/idsWithNames"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wyszukiwanie galerii po filtrach, np. VIN, numerze rejestracyjnym lub zakresie dat."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listowanie galerii"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/list/vin/{vin}"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/list/numberplates/{numberplates}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pobieranie listy wszystkich galerii przypisanych do pojazdu."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Najnowsza galeria"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/vin/{vin}"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/numberplates/{numberplates}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pobieranie najnowszej galerii pojazdu."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Zdjęcia"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/image-set"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pobieranie zestawów zdjęć, hotspotów, danych video i zdjęć 1080p."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ogłoszenia"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/add-announcement"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dodawanie ogłoszeń przez integracje eksportujące dane."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dzięki temu wygenerowana sekcja ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Reference"]}," w Redocly nie pokazuje technicznych nazw kontrolerów, takich jak ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VirtualCarControllerV"]}," lub ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VirtualCarControllerV2"]},", tylko nazwy zrozumiałe dla integratora."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"typowy-proces-integracji","__idx":10},"children":["Typowy proces integracji"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Najczęstszy proces integracji z API składa się z dwóch kroków."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"krok-1--wyszukaj-galerię-pojazdu","__idx":11},"children":["Krok 1 — wyszukaj galerię pojazdu"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pobierz najnowszą galerię po numerze VIN:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://img-out.virtualcar360.pl/api/v6.0/virtual-360/vin/WBA1234567890?key=TWOJ_KLUCZ_API\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["albo po numerze rejestracyjnym:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://img-out.virtualcar360.pl/api/v6.0/virtual-360/numberplates/WW4433E?key=TWOJ_KLUCZ_API\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykładowa odpowiedź:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": 10209937,\n  \"name\": \"WBA1234567890_skodaplus\",\n  \"vin\": \"WBA1234567890\",\n  \"numberPlates\": \"WW4433E\",\n  \"createdAt\": \"2026-04-21T10:42:30.3038179\",\n  \"type\": \"3000_2250_8_JPG_SKODAPLUS\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wartość ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," z odpowiedzi wykorzystaj jako ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carId"]}," w kolejnym zapytaniu."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"krok-2--pobierz-zestaw-zdjęć","__idx":12},"children":["Krok 2 — pobierz zestaw zdjęć"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://img-out.virtualcar360.pl/api/v6.0/virtual-360/image-set?carId=10209937&key=TWOJ_KLUCZ_API\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Endpoint zwraca pełny obiekt galerii, w tym zestawy zdjęć, hotspoty i linki do materiałów video."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pobieranie-najnowszej-galerii","__idx":13},"children":["Pobieranie najnowszej galerii"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"po-numerze-vin","__idx":14},"children":["Po numerze VIN"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /vin/{vin}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://img-out.virtualcar360.pl/api/v6.0/virtual-360/vin/WBA1234567890?key=TWOJ_KLUCZ_API\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Użyj tego endpointu, jeżeli interesuje Cię aktualna, najnowsza galeria pojazdu."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"po-numerze-rejestracyjnym","__idx":15},"children":["Po numerze rejestracyjnym"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /numberplates/{numberplates}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://img-out.virtualcar360.pl/api/v6.0/virtual-360/numberplates/WW4433E?key=TWOJ_KLUCZ_API\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ten endpoint jest przydatny, gdy system klienta identyfikuje pojazdy po numerze rejestracyjnym zamiast po numerze VIN."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"listowanie-galerii","__idx":16},"children":["Listowanie galerii"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Jeden pojazd może posiadać wiele galerii. Endpointy listujące pozwalają pobrać historię galerii przypisanych do konkretnego VIN albo numeru rejestracyjnego."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"lista-galerii-po-vin","__idx":17},"children":["Lista galerii po VIN"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /list/vin/{vin}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://img-out.virtualcar360.pl/api/v6.0/virtual-360/list/vin/WBA1234567890?key=TWOJ_KLUCZ_API&Sorting=-1&Page=1&PageSize=20\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"lista-galerii-po-numerze-rejestracyjnym","__idx":18},"children":["Lista galerii po numerze rejestracyjnym"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /list/numberplates/{numberplates}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://img-out.virtualcar360.pl/api/v6.0/virtual-360/list/numberplates/WW4433E?key=TWOJ_KLUCZ_API&Sorting=-1&Page=1&PageSize=20\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"paginacja-i-sortowanie","__idx":19},"children":["Paginacja i sortowanie"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Endpointy listujące obsługują parametry:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parametr"},"children":["Parametr"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Opis"},"children":["Opis"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sorting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Kierunek sortowania. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}," oznacza ASC, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-1"]}," oznacza DESC."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Page"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Numer strony. Domyślnie ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PageSize"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Liczba wyników na stronę. Zakres ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1–100"]},", domyślnie ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["20"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://img-out.virtualcar360.pl/api/v6.0/virtual-360/list/vin/WBA1234567890?key=TWOJ_KLUCZ_API&Sorting=-1&Page=1&PageSize=20\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pobieranie-zestawu-zdjęć","__idx":20},"children":["Pobieranie zestawu zdjęć"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/image-set"]}," jest głównym endpointem do pobierania zdjęć i danych galerii."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /image-set?carId={carId}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://img-out.virtualcar360.pl/api/v6.0/virtual-360/image-set?carId=10209937&key=TWOJ_KLUCZ_API\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Odpowiedź może zawierać:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vin"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numberPlates"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inspection"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["video"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hotspots"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carImageSets"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carImageSets1080p"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykładowa uproszczona odpowiedź:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"10209937\",\n  \"vin\": \"WBA1234567890\",\n  \"numberPlates\": \"WW4433E\",\n  \"type\": \"3000_2250_8_JPG_SKODAPLUS\",\n  \"inspection\": null,\n  \"video\": \"{\\\"vimeo\\\":\\\"https://vimeo.com/1185086568/3943c5fe00\\\",\\\"youtube\\\":\\\"https://youtu.be/mQRMs7IyYtk\\\"}\",\n  \"hotspots\": [],\n  \"carImageSets\": [\n    {\n      \"type\": \"exterior-closed\",\n      \"images\": [\n        {\n          \"url\": \"https://vc360prodeuwstorageacc.blob.core.windows.net/example/keyframe_1.jpg\",\n          \"type\": \"exterior-closed\"\n        }\n      ]\n    }\n  ],\n  \"carImageSets1080p\": []\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"typy-zestawów-zdjęć","__idx":21},"children":["Typy zestawów zdjęć"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Najczęściej spotykane typy zestawów zdjęć:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Typ"},"children":["Typ"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Opis"},"children":["Opis"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["exterior-closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Zdjęcia zewnętrzne samochodu, zwykle z zamkniętymi drzwiami."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additional"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Zdjęcia dodatkowe, na przykład detale, wnętrze lub zdjęcia uzupełniające."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Zakres typów może zależeć od standardu zdjęć i konfiguracji konta."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pole-type","__idx":22},"children":["Pole ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pole ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," opisuje techniczny standard zdjęć. Może zawierać między innymi:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["szerokość zdjęcia,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["wysokość zdjęcia,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["liczbę zdjęć,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["format pliku,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["nazwę standardu."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"txt","header":{"controls":{"copy":{}}},"source":"3000_2250_8_JPG_SKODAPLUS\n","lang":"txt"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Interpretacja:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Segment"},"children":["Segment"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"right","data-label":"Wartość"},"children":["Wartość"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Opis"},"children":["Opis"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["szerokość"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3000"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Szerokość zdjęcia w pikselach."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["wysokość"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2250"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wysokość zdjęcia w pikselach."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["liczba zdjęć"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Liczba zdjęć w zestawie."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["format"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JPG"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Format pliku."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["standard"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SKODAPLUS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nazwa standardu fotograficznego."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"video-w-api","__idx":23},"children":["Video w API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Jeżeli galeria posiada materiał video, pole ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["video"]}," może zawierać string z JSON-em."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład wartości pola ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["video"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"{\\\"vimeo\\\":\\\"https://vimeo.com/1185086568/3943c5fe00\\\",\\\"youtube\\\":\\\"https://youtu.be/mQRMs7IyYtk\\\"}\"\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Aby odczytać linki, wykonaj ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JSON.parse()"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"js","header":{"controls":{"copy":{}}},"source":"if (data.video) {\n  const video = JSON.parse(data.video);\n\n  console.log(video.vimeo);\n  console.log(video.youtube);\n}\n","lang":"js"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Jeżeli galeria nie posiada video, pole może mieć wartość ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"hotspoty-w-api","__idx":24},"children":["Hotspoty w API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Hotspoty są zwracane w polu ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hotspots"]},". Hotspot wskazuje konkretny punkt na zdjęciu i może posiadać powiązane zdjęcia dodatkowe albo materiały video."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykładowy hotspot:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"imageId\": \"1f78b180-7f0b-4a8a-a6a4-2a2e95b36436\",\n  \"ox\": 45.5,\n  \"oy\": 62.25,\n  \"category\": 1,\n  \"categoryName\": \"Damage\",\n  \"info\": \"Rysa na zderzaku\",\n  \"relatedPhotos\": [\n    \"7f2d4e6f-7e2c-41a3-a907-97be32f0b5de\"\n  ],\n  \"relatedVideos\": []\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Współrzędne ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ox"]}," i ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oy"]}," określają pozycję hotspotu na zdjęciu."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"wyszukiwanie-po-filtrach","__idx":25},"children":["Wyszukiwanie po filtrach"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/idsWithNames"]}," umożliwia wyszukiwanie galerii z użyciem filtrów."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dostępne filtry:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parametr"},"children":["Parametr"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Opis"},"children":["Opis"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dokładny numer VIN."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numberPlates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dokładny numer rejestracyjny."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vinLike"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fragment numeru VIN."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numberPlatesLike"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fragment numeru rejestracyjnego."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAtFrom"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Data utworzenia od."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAtTo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Data utworzenia do."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sorting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Kierunek sortowania."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Page"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Numer strony."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PageSize"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Liczba wyników na stronie."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://img-out.virtualcar360.pl/api/v6.0/virtual-360/idsWithNames?key=TWOJ_KLUCZ_API&vinLike=WBA&Sorting=-1&Page=1&PageSize=20\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"przykład-integracji-w-javascript","__idx":26},"children":["Przykład integracji w JavaScript"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"js","header":{"controls":{"copy":{}}},"source":"async function getLatestGalleryByVin(vin, apiKey) {\n  const url = new URL(\n    `https://img-out.virtualcar360.pl/api/v6.0/virtual-360/vin/${encodeURIComponent(vin)}`\n  );\n\n  url.searchParams.set('key', apiKey);\n\n  const response = await fetch(url);\n\n  if (!response.ok) {\n    throw new Error(`VirtualCar360 API error: ${response.status}`);\n  }\n\n  return response.json();\n}\n\nasync function getImageSet(carId, apiKey) {\n  const url = new URL('https://img-out.virtualcar360.pl/api/v6.0/virtual-360/image-set');\n\n  url.searchParams.set('carId', carId);\n  url.searchParams.set('key', apiKey);\n\n  const response = await fetch(url);\n\n  if (!response.ok) {\n    throw new Error(`VirtualCar360 API error: ${response.status}`);\n  }\n\n  return response.json();\n}\n\nconst gallery = await getLatestGalleryByVin('WBA1234567890', 'TWOJ_KLUCZ_API');\nconst imageSet = await getImageSet(gallery.id, 'TWOJ_KLUCZ_API');\n\nconsole.log(imageSet.carImageSets);\n","lang":"js"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-a-player","__idx":27},"children":["API a Player"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API oraz Player rozwiązują podobny problem, ale w inny sposób."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obszar"},"children":["Obszar"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API"},"children":["API"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Player"},"children":["Player"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cel"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pobranie danych do własnej aplikacji"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Gotowa prezentacja do osadzenia"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integracja"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Backend, CRM, DMS, system klienta"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UI"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Budowany przez klienta"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dostarczany przez VirtualCar360"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Zdjęcia"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Zwracane jako URL-e"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Renderowane automatycznie"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hotspoty"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Zwracane jako dane"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Obsługiwane automatycznie w Playerze"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Video"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Zwracane jako linki"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Widoczne w Playerze, jeśli dostępne"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"kody-odpowiedzi","__idx":28},"children":["Kody odpowiedzi"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"right","data-label":"Kod"},"children":["Kod"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Znaczenie"},"children":["Znaczenie"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Zapytanie wykonane poprawnie."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nieprawidłowe parametry zapytania."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nie znaleziono galerii lub danych dla podanych kryteriów."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Błąd serwera. Skontaktuj się z supportem VirtualCar360."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"dobre-praktyki","__idx":29},"children":["Dobre praktyki"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Używaj backend proxy i nie ujawniaj klucza API w kodzie frontendowym."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Jeżeli masz ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carId"]},", używaj ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/image-set"]}," bezpośrednio."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Jeżeli masz VIN albo numer rejestracyjny, najpierw pobierz najnowszą galerię, a następnie użyj jej ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Dla listingów ofert stosuj cache po stronie własnego systemu, aby nie pobierać tych samych danych wielokrotnie."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["W przypadku wielu lokalizacji używaj klucza grupowego."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obsługuj sytuację, w której galeria nie posiada video albo hotspotów."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Nie zakładaj, że każdy pojazd ma więcej niż jedną galerię."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Przy listowaniu danych używaj paginacji."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["W logach nie zapisuj pełnych URL-i zawierających parametr ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["key"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"powiązany-plik-openapi","__idx":30},"children":["Powiązany plik OpenAPI"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Szczegółowy opis endpointów, parametrów, schematów odpowiedzi i przykładów znajduje się w pliku ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["openapi.json"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Plik może być użyty w Redocly jako źródło dla sekcji ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Reference"]},"."]}]},"headings":[{"value":"API","id":"api","depth":1},{"value":"Base URL","id":"base-url","depth":2},{"value":"Autoryzacja","id":"autoryzacja","depth":2},{"value":"Najważniejsze pojęcia","id":"najważniejsze-pojęcia","depth":2},{"value":"Galeria","id":"galeria","depth":3},{"value":"Zestaw zdjęć","id":"zestaw-zdjęć","depth":3},{"value":"Hotspot","id":"hotspot","depth":3},{"value":"Video","id":"video","depth":3},{"value":"Endpointy","id":"endpointy","depth":2},{"value":"Podział endpointów w API Reference","id":"podział-endpointów-w-api-reference","depth":2},{"value":"Typowy proces integracji","id":"typowy-proces-integracji","depth":2},{"value":"Krok 1 — wyszukaj galerię pojazdu","id":"krok-1--wyszukaj-galerię-pojazdu","depth":3},{"value":"Krok 2 — pobierz zestaw zdjęć","id":"krok-2--pobierz-zestaw-zdjęć","depth":3},{"value":"Pobieranie najnowszej galerii","id":"pobieranie-najnowszej-galerii","depth":2},{"value":"Po numerze VIN","id":"po-numerze-vin","depth":3},{"value":"Po numerze rejestracyjnym","id":"po-numerze-rejestracyjnym","depth":3},{"value":"Listowanie galerii","id":"listowanie-galerii","depth":2},{"value":"Lista galerii po VIN","id":"lista-galerii-po-vin","depth":3},{"value":"Lista galerii po numerze rejestracyjnym","id":"lista-galerii-po-numerze-rejestracyjnym","depth":3},{"value":"Paginacja i sortowanie","id":"paginacja-i-sortowanie","depth":2},{"value":"Pobieranie zestawu zdjęć","id":"pobieranie-zestawu-zdjęć","depth":2},{"value":"Typy zestawów zdjęć","id":"typy-zestawów-zdjęć","depth":2},{"value":"Pole type","id":"pole-type","depth":2},{"value":"Video w API","id":"video-w-api","depth":2},{"value":"Hotspoty w API","id":"hotspoty-w-api","depth":2},{"value":"Wyszukiwanie po filtrach","id":"wyszukiwanie-po-filtrach","depth":2},{"value":"Przykład integracji w JavaScript","id":"przykład-integracji-w-javascript","depth":2},{"value":"API a Player","id":"api-a-player","depth":2},{"value":"Kody odpowiedzi","id":"kody-odpowiedzi","depth":2},{"value":"Dobre praktyki","id":"dobre-praktyki","depth":2},{"value":"Powiązany plik OpenAPI","id":"powiązany-plik-openapi","depth":2}],"frontmatter":{"seo":{"title":"API"}},"lastModified":"2026-06-16T22:34:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}