--- title: "Dashboard: technologie (`getTechnologies`)" source: https://docs.senuto.com/modules/visibility_analysis/va-dashboard-getTechnologies api: GET /api/visibility_analysis/reports/dashboard/getTechnologies --- # Dashboard: technologie (`getTechnologies`) **`GET /api/visibility_analysis/reports/dashboard/getTechnologies`** Zwraca listę technologii wykrytych na analizowanej domenie (np. serwer WWW, CDN, narzędzia marketingowe) w formie prostej tablicy: nazwa technologii oraz nazwa pliku jej ikony. To lekki endpoint dashboardu Analizy widoczności — bez paginacji i bez dodatkowych statystyk. | Nazwa | Plik ikony | | --- | --- | | ActiveCampaign | activecampaign.png | | Google Cloud | google_cloud.svg | | Google Cloud CDN | google_cloud_cdn.svg | | Nginx | Nginx.svg | _zalando.pl — technologie wykryte na domenie (endpoint bez paginacji). Wszystkie adresowalne pola wiersza._ --- ## Żądanie `GET` `/api/visibility_analysis/reports/dashboard/getTechnologies` Nagłówki: `Authorization: Bearer `. Parametry przekazywane w query stringu. ### Struktura żądania **Podstawowy** ```text filename="query-string.txt" /api/visibility_analysis/reports/dashboard/getTechnologies ?domain=zalando.pl &fetch_mode=topLevelDomain &country_id=1 ``` **cURL** ```bash curl --location --request GET 'https://api.senuto.com/api/visibility_analysis/reports/dashboard/getTechnologies?domain=zalando.pl&fetch_mode=topLevelDomain&country_id=1' \ --header 'Authorization: Bearer $YOUR_TOKEN_HERE' ``` ### Parametry ```ts type DashboardGetTechnologiesRequest = { /** * **Wymagane**. Domena, subdomena, katalog lub URL do analizy — interpretowane zgodnie z `fetch_mode`. */ domain: string; /** * **Wymagane**. Sposób interpretacji `domain`. * - `topLevelDomain` — cała domena * - `subdomain` — pojedyncza subdomena * - `catalog` — ścieżka/katalog * - `url` — dokładny URL */ fetch_mode: 'topLevelDomain' | 'subdomain' | 'catalog' | 'url'; /** * Id kraju (bazy danych). Polska = `1`. W tym endpoincie **opcjonalne** * (walidator `GetTechnologiesValidator`); podana nieznana wartość → `418` z komunikatem `Unknown country_id`. */ country_id?: number; } export default DashboardGetTechnologiesRequest ``` > **Ostrzeżenie:** > Dwa parametry są **wymagane**: **`domain`** oraz **`fetch_mode`** (walidator `GetTechnologiesValidator`); `country_id` jest tutaj **opcjonalne** — inaczej niż w większości endpointów tego modułu. To endpoint **GET** — parametry przekazujesz w query stringu. Jeśli podasz `country_id`, nieznana wartość zwraca `418` z komunikatem `Unknown country_id`. ## Odpowiedź W przypadku powodzenia otrzymujesz `data` — tablicę wykrytych technologii. Każdy element zawiera `name` (nazwę technologii) oraz `icon` (nazwę pliku ikony, np. `activecampaign.png` lub `Nginx.svg` — bez pełnego adresu URL). Endpoint nie zwraca paginacji. **Skrócona** ```json filename="przykładowa-odpowiedź (skrócona)" { "success": true, "data": [ { "name": "Nginx", "icon": "Nginx.svg" } ] } ``` **Pełna** ```json filename="przykładowa-odpowiedź (200)" { "success": true, "data": [ { "name": "ActiveCampaign", "icon": "activecampaign.png" }, { "name": "Google Cloud", "icon": "google_cloud.svg" }, { "name": "Google Cloud CDN", "icon": "google_cloud_cdn.svg" }, { "name": "Nginx", "icon": "Nginx.svg" } ] } ``` ### Struktura odpowiedzi ```ts type DashboardTechnologiesResponse = { /** `true` przy powodzeniu; przy błędzie `false` i koperta z `error` */ success: boolean; /** Lista technologii wykrytych na domenie */ data: Technology[]; } type Technology = { /** Nazwa technologii, np. "Nginx", "Google Cloud CDN" */ name: string; /** Nazwa pliku ikony, np. "activecampaign.png" lub "Nginx.svg" (bez pełnego URL) */ icon: string; } export default DashboardTechnologiesResponse ``` ## Błędy ```ts type ErrorResponse = { success: false; data: { error: { /** np. invalid_data, database, timeout, unknown */ type: string; message: string; /** pole -> reguła -> komunikat (dla invalid_data) */ params?: Record>; }; }; } export default ErrorResponse ``` > **Błąd:** > **`418`** zwracany jest również dla błędów walidacji — nie tylko przy ograniczeniu liczby żądań (rate limiting). Brak `domain` lub `fetch_mode` → odpowiedź `invalid_data`; podanie nieznanego `country_id` → komunikat `Unknown country_id`. ## Powiązane akcje - `getTechnologies` — technologie wykryte na domenie (ta strona) - `getDomainStatistics` — zbiorcze statystyki widoczności domeny na dashboardzie - `getDomainData` — podstawowe dane analizowanej domeny