{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Certificate","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":"certificate","__idx":0},"children":["Certificate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Certyfikat pojazdu VirtualCar360 może być udostępniany niezależnie od Playera za pomocą dedykowanego endpointu API. Endpoint pozwala pobrać linki do certyfikatu w kilku formach:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["jako ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["widget"]}," do osadzenia w ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["jako ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["onepage"]},", czyli pełna strona certyfikatu,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["jako pliki ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PDF"]}," w dostępnych wersjach językowych."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Certyfikaty mogą być również widoczne bezpośrednio w Playerze, jeżeli są dostępne dla danej galerii lub pojazdu. Endpoint opisany w tej sekcji służy jednak do rozszerzonego procesu udostępniania certyfikatu niezależnie od Playera, na przykład we własnym systemie, stronie pojazdu, CRM, DMS albo portalu ogłoszeniowym."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Informacja"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Jeżeli korzystasz z Playera, certyfikat może być widoczny bezpośrednio w jego interfejsie. Endpoint certyfikatu jest przeznaczony dla integracji, które chcą pobrać i wyświetlić certyfikat samodzielnie."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"dostęp-do-certyfikatów","__idx":1},"children":["Dostęp do certyfikatów"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dostęp do endpointu wymaga ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]},". Klucz może zostać wydany przez support VirtualCar360:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dla pojedynczej lokalizacji,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dla całej organizacji,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dla grupy lokalizacji lub dealerów."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Zakres danych zwracanych przez endpoint zależy od uprawnień przypisanych do danego klucza."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Bezpieczeństwo"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]}," powinien być traktowany jako informacja poufna. Jeżeli certyfikat pobierany jest przez API, zalecane jest wykonywanie zapytania przez backend klienta, aby nie ujawniać klucza w kodzie frontendowym."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint","__idx":2},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://api-certificate.vc360.app/api/v1/{apiKey}/certificate/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://api-certificate.vc360.app/api/v1/a0d8eb5cd984c08a58e7b88a/certificate/vin/WVWZZZ3H5RE500898\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"parametry-ścieżki","__idx":3},"children":["Parametry ścieżki"]},{"$$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":{"align":"right","data-label":"Typ"},"children":["Typ"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"right","data-label":"Wymagany"},"children":["Wymagany"]},{"$$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":["apiKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["tak"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Klucz API wydany przez support VirtualCar360 dla lokalizacji, grupy lokalizacji albo całej organizacji."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["tak"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Numer VIN pojazdu, dla którego ma zostać pobrany certyfikat."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"przykład-zapytania-curl","__idx":4},"children":["Przykład zapytania cURL"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \\\n \"https://api-certificate.vc360.app/api/v1/TWOJ_API_KEY/certificate/vin/WVWZZZ3H5RE500898\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"przykładowa-odpowiedź","__idx":5},"children":["Przykładowa odpowiedź"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"widget\": \"https://certificate.vc360.app/widget/inspection-pia/1f093ac5-dd71-6f24-8abc-c735770b85d5/pl\",\n \"onepage\": \"https://certificate.vc360.app/certificate/inspection-pia/1f093ac5-dd71-6f24-8abc-c735770b85d5/pl\",\n \"pdf\": [\n {\n \"language\": \"pl\",\n \"code\": \"pia-pdf\",\n \"fileUrl\": \"https://vc360inspectionstorage.blob.core.windows.net/inspectiondata/2025/pdf/example/example-pia-pdf-pl.pdf?...\"\n },\n {\n \"language\": \"en\",\n \"code\": \"pia-pdf\",\n \"fileUrl\": \"https://vc360inspectionstorage.blob.core.windows.net/inspectiondata/2025/pdf/example/example-pia-pdf-en.pdf?...\"\n }\n ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Uwaga"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adresy PDF mogą zawierać czasowe parametry dostępu. Nie należy zakładać, że link do pliku PDF będzie ważny bezterminowo."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pola-odpowiedzi","__idx":6},"children":["Pola 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":{"data-label":"Pole"},"children":["Pole"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"right","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":["widget"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL do wersji widgetowej certyfikatu. Najlepszy wybór do osadzenia w ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]}," we własnej stronie lub systemie."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onepage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL do pełnej strony certyfikatu. Może zostać otwarty jako osobna strona albo osadzony w ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lista dostępnych wersji PDF certyfikatu."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf[].language"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Kod języka pliku PDF, np. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pl"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf[].code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Kod typu dokumentu PDF, np. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pia-pdf"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf[].fileUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL do pliku PDF. Link może być czasowy."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"formy-udostępniania-certyfikatu","__idx":7},"children":["Formy udostępniania certyfikatu"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"widget","__idx":8},"children":["Widget"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Widget jest przeznaczony do osadzenia we własnym interfejsie za pomocą ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]},". Jest to zalecany wariant, jeżeli certyfikat ma być częścią strony szczegółów pojazdu albo panelu klienta."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"
\n \n
\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"css","header":{"controls":{"copy":{}}},"source":".certificate-widget-wrapper {\n width: 100%;\n min-height: 720px;\n}\n\n.certificate-widget-wrapper iframe {\n width: 100%;\n height: 720px;\n border: 0;\n}\n","lang":"css"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"onepage","__idx":9},"children":["Onepage"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Onepage to pełna strona certyfikatu. Może być wykorzystana jako osobny link, przycisk ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Zobacz certyfikat"]}," albo osadzona w ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład linku:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"\n Zobacz certyfikat pojazdu\n\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład osadzenia onepage w ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"
\n \n
\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"css","header":{"controls":{"copy":{}}},"source":".certificate-onepage-wrapper {\n width: 100%;\n min-height: 900px;\n}\n\n.certificate-onepage-wrapper iframe {\n width: 100%;\n height: 900px;\n border: 0;\n}\n","lang":"css"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pdf","__idx":10},"children":["PDF"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pole ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]}," zawiera listę dostępnych plików PDF. Każdy element listy reprezentuje jeden wariant językowy dokumentu."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład wyświetlenia linków PDF:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"
\n \n Pobierz certyfikat PDF — PL\n \n\n \n Pobierz certyfikat PDF — EN\n \n
\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Wersje językowe"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wersje ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["widget"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onepage"]}," oraz ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]}," mogą występować w wielu językach. Dostępne języki zależą od konfiguracji certyfikatu i danych zwróconych przez API."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"wersje-językowe","__idx":11},"children":["Wersje językowe"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adresy ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["widget"]}," i ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onepage"]}," mogą zawierać segment języka na końcu URL, na przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"txt","header":{"controls":{"copy":{}}},"source":"/pl\n","lang":"txt"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład wersji polskiej:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"txt","header":{"controls":{"copy":{}}},"source":"https://certificate.vc360.app/widget/inspection-pia/1f093ac5-dd71-6f24-8abc-c735770b85d5/pl\n","lang":"txt"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Jeżeli dostępne są inne wersje językowe, mogą zostać udostępnione analogicznie, na przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"txt","header":{"controls":{"copy":{}}},"source":"https://certificate.vc360.app/widget/inspection-pia/1f093ac5-dd71-6f24-8abc-c735770b85d5/en\n","lang":"txt"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pliki PDF zwracane są w tablicy ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]},", gdzie język dokumentu określa pole ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Przykład:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"language\": \"en\",\n \"code\": \"pia-pdf\",\n \"fileUrl\": \"https://vc360inspectionstorage.blob.core.windows.net/inspectiondata/2025/pdf/example/example-pia-pdf-en.pdf?...\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"typowy-proces-integracji","__idx":12},"children":["Typowy proces integracji"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uzyskaj ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]}," od supportu VirtualCar360."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wywołaj endpoint certyfikatu dla wybranego numeru VIN."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Odczytaj z odpowiedzi pola ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["widget"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onepage"]}," i ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Osadź ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["widget"]}," w ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]}," albo pokaż link do ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onepage"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Udostępnij użytkownikowi pliki PDF w dostępnych językach."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obsłuż przypadek, w którym certyfikat nie jest dostępny dla pojazdu."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"przykład-integracji-w-javascript","__idx":13},"children":["Przykład integracji w JavaScript"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"js","header":{"controls":{"copy":{}}},"source":"async function getCertificateByVin({ apiKey, vin }) {\n const url = `https://api-certificate.vc360.app/api/v1/${encodeURIComponent(apiKey)}/certificate/vin/${encodeURIComponent(vin)}`;\n\n const response = await fetch(url);\n\n if (!response.ok) {\n throw new Error(`Certificate API error: ${response.status}`);\n }\n\n return response.json();\n}\n\nconst certificate = await getCertificateByVin({\n apiKey: 'TWOJ_API_KEY',\n vin: 'WVWZZZ3H5RE500898',\n});\n\nconsole.log(certificate.widget);\nconsole.log(certificate.onepage);\nconsole.log(certificate.pdf);\n","lang":"js"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"przykład-renderowania-widgetu","__idx":14},"children":["Przykład renderowania widgetu"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"js","header":{"controls":{"copy":{}}},"source":"function renderCertificateWidget(certificate) {\n if (!certificate?.widget) {\n return '';\n }\n\n return `\n \n `;\n}\n","lang":"js"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"przykład-renderowania-linków-pdf","__idx":15},"children":["Przykład renderowania linków PDF"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"js","header":{"controls":{"copy":{}}},"source":"function renderCertificatePdfLinks(certificate) {\n if (!certificate?.pdf?.length) {\n return '';\n }\n\n return certificate.pdf\n .map((item) => {\n const language = item.language.toUpperCase();\n\n return `\n \n Pobierz certyfikat PDF — ${language}\n \n `;\n })\n .join('');\n}\n","lang":"js"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"certyfikat-w-playerze-a-endpoint-api","__idx":16},"children":["Certyfikat w Playerze a endpoint API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Certyfikat może być widoczny bezpośrednio w Playerze, jeżeli jest dostępny dla danego pojazdu. W takim przypadku użytkownik może zobaczyć certyfikat w ramach gotowej prezentacji pojazdu."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Endpoint certyfikatu jest przeznaczony dla bardziej zaawansowanych integracji, które chcą:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["wyświetlić certyfikat poza Playerem,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["osadzić certyfikat w innym miejscu strony,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dodać przycisk ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Zobacz certyfikat"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["pobrać pliki PDF,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["wykorzystać certyfikat w CRM, DMS lub systemie administracyjnym,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["udostępnić certyfikat w wielu językach."]}]},{"$$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":"Scenariusz"},"children":["Scenariusz"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Zalecane rozwiązanie"},"children":["Zalecane rozwiązanie"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certyfikat jako część gotowej prezentacji pojazdu"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Player"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certyfikat osadzony w osobnej sekcji strony"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["widget"]}," w ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certyfikat jako osobna strona"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onepage"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certyfikat do pobrania lub wysłania klientowi"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certyfikat w CRM lub DMS"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["endpoint API"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"obsługa-braku-certyfikatu","__idx":17},"children":["Obsługa braku certyfikatu"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Nie każdy pojazd musi posiadać certyfikat. Integracja powinna obsługiwać sytuacje, w których:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["certyfikat nie istnieje dla podanego VIN,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["klucz API nie ma dostępu do danej lokalizacji,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["certyfikat nie posiada wersji PDF,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["certyfikat nie posiada wybranej wersji językowej,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["link PDF wygasł i wymaga ponownego pobrania z API."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Dobra praktyka"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Nie zapisuj na stałe linków PDF z odpowiedzi API jako bezterminowych adresów. Jeżeli plik PDF ma czasowy URL, pobieraj aktualny link z API przed jego pokazaniem użytkownikowi."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"dobre-praktyki","__idx":18},"children":["Dobre praktyki"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pobieraj certyfikat przez backend klienta, aby nie ujawniać ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Używaj ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["widget"]},", gdy certyfikat ma być osadzony w stronie."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Używaj ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onepage"]},", gdy certyfikat ma otwierać się jako osobna strona."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Używaj ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]},", gdy użytkownik ma pobrać dokument lub przekazać go dalej."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sprawdzaj, czy odpowiedź zawiera oczekiwane pola."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obsługuj wiele wersji językowych."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Nie zakładaj, że certyfikat istnieje dla każdego pojazdu."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Nie przechowuj czasowych linków PDF jako stałych adresów."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Dla wielu lokalizacji używaj klucza organizacyjnego lub grupowego."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"najczęstsze-problemy","__idx":19},"children":["Najczęstsze problemy"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"certyfikat-nie-został-znaleziony","__idx":20},"children":["Certyfikat nie został znaleziony"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sprawdź, czy:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["VIN jest poprawny,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["pojazd posiada certyfikat,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]}," ma dostęp do właściwej lokalizacji,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["certyfikat został już wygenerowany."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"link-pdf-nie-działa","__idx":21},"children":["Link PDF nie działa"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Możliwe przyczyny:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["link PDF wygasł,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["plik PDF nie jest dostępny w wybranym języku,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["certyfikat został ponownie wygenerowany,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dostęp do pliku wymaga pobrania aktualnego URL z API."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["W takim przypadku pobierz dane certyfikatu ponownie przez endpoint API."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"widget-nie-wyświetla-się-w-iframe","__idx":22},"children":["Widget nie wyświetla się w iframe"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sprawdź, czy:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["URL z pola ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["widget"]}," jest poprawny,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["certyfikat jest dostępny,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["strona nie blokuje osadzania iframe,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["iframe ma ustawioną odpowiednią wysokość,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["użytkownik ma dostęp do internetu i domeny ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["certificate.vc360.app"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"brakuje-wersji-językowej","__idx":23},"children":["Brakuje wersji językowej"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dostępne języki zależą od konfiguracji certyfikatu i danych zwróconych przez API. Jeżeli wymagana wersja językowa nie jest dostępna, skontaktuj się z supportem VirtualCar360."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"podsumowanie","__idx":24},"children":["Podsumowanie"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Endpoint certyfikatu pozwala pobrać certyfikat pojazdu niezależnie od Playera. Odpowiedź zawiera link do widgetu, pełnej strony onepage oraz listę plików PDF w dostępnych wersjach językowych."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Certyfikat może być prezentowany bezpośrednio w Playerze, ale dedykowany endpoint API daje większą elastyczność: pozwala osadzać certyfikat w dowolnym miejscu strony, udostępniać pliki PDF i integrować dane certyfikatu z systemami klienta."]}]},"headings":[{"value":"Certificate","id":"certificate","depth":1},{"value":"Dostęp do certyfikatów","id":"dostęp-do-certyfikatów","depth":2},{"value":"Endpoint","id":"endpoint","depth":2},{"value":"Parametry ścieżki","id":"parametry-ścieżki","depth":2},{"value":"Przykład zapytania cURL","id":"przykład-zapytania-curl","depth":2},{"value":"Przykładowa odpowiedź","id":"przykładowa-odpowiedź","depth":2},{"value":"Pola odpowiedzi","id":"pola-odpowiedzi","depth":2},{"value":"Formy udostępniania certyfikatu","id":"formy-udostępniania-certyfikatu","depth":2},{"value":"Widget","id":"widget","depth":3},{"value":"Onepage","id":"onepage","depth":3},{"value":"PDF","id":"pdf","depth":3},{"value":"Wersje językowe","id":"wersje-językowe","depth":2},{"value":"Typowy proces integracji","id":"typowy-proces-integracji","depth":2},{"value":"Przykład integracji w JavaScript","id":"przykład-integracji-w-javascript","depth":2},{"value":"Przykład renderowania widgetu","id":"przykład-renderowania-widgetu","depth":2},{"value":"Przykład renderowania linków PDF","id":"przykład-renderowania-linków-pdf","depth":2},{"value":"Certyfikat w Playerze a endpoint API","id":"certyfikat-w-playerze-a-endpoint-api","depth":2},{"value":"Obsługa braku certyfikatu","id":"obsługa-braku-certyfikatu","depth":2},{"value":"Dobre praktyki","id":"dobre-praktyki","depth":2},{"value":"Najczęstsze problemy","id":"najczęstsze-problemy","depth":2},{"value":"Certyfikat nie został znaleziony","id":"certyfikat-nie-został-znaleziony","depth":3},{"value":"Link PDF nie działa","id":"link-pdf-nie-działa","depth":3},{"value":"Widget nie wyświetla się w iframe","id":"widget-nie-wyświetla-się-w-iframe","depth":3},{"value":"Brakuje wersji językowej","id":"brakuje-wersji-językowej","depth":3},{"value":"Podsumowanie","id":"podsumowanie","depth":2}],"frontmatter":{"seo":{"title":"Certificate"}},"lastModified":"2026-06-16T21:52:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/certificate","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}