---
title: "Reports (SSL / WHOIS) — API v1 i MCP | Dokumentacja Nodea"
description: "Reference raportów SSL i WHOIS: endpointy API v1 z filtrami status/expiry/sort, zakres monitoring:read, flagi report_ssl/report_whois, narzędzia MCP report-ssl/report-whois i przykłady."
url: "https://nodea.pl/pl/dokumentacja-api/reports"
lang: "pl"
updated: "2026-07-16"
---

# Reports (SSL / WHOIS) — API v1 i MCP | Dokumentacja Nodea

> Reference modułu Reports — raporty terminów ważności SSL i WHOIS: endpointy API v1 (filtry status/expiry/sort), zakres monitoring:read, narzędzia MCP i przykłady.

Moduł **Reports** udostępnia dwa raporty terminów ważności liczone po stronach WWW użytkownika (własne + zaakceptowane udziały): **SSL** (certyfikaty) i **WHOIS** (rejestracja domen). Każdy wiersz powstaje z testu SSL/WHOIS strony i szczegółów (details) jego ostatniego uruchomienia (payload zadania SSLJob/WhoisJob). To raporty tylko do odczytu — nie ma osobnego modelu, dane są projekcją z ostatnich testów.

## Uwierzytelnianie, zakresy i flagi

Bearer token Passport. Oba endpointy wymagają zakresu monitoring:read. Bramkowanie flagami per raport: /reports/ssl → features:report\_ssl, /reports/whois → features:report\_whois. Zbiór jest ograniczony limitem planu (kilkaset testów na użytkownika), więc filtrowanie i sortowanie odbywa się w pamięci.

## API v1 — endpointy

MetodaŚcieżkaScopeOpisGET/api/v1/reports/sslmonitoring:readRaport wygasania certyfikatów SSL, paginowany. GET/api/v1/reports/whoismonitoring:readRaport wygasania rejestracji domen (WHOIS), paginowany.

### Parametry zapytania (wspólne)

- search (string, max 255) — po nazwie i URL strony.
- status (enum: valid|invalid|unknown) — filtr ważności (tri-state is\_valid).
- expiry (enum: expired|lt7|lt30|lt90|valid) — okno czasowe do wygaśnięcia.
- sort — whitelist zależny od raportu (patrz niżej), domyślnie expiration\_date; direction (asc|desc).
- per\_page (int 1–100, domyślnie 25), page.

Whitelist sortowania SSL: is\_valid, website, days, expiration\_date, last\_run, issuer, organization. WHOIS: is\_valid, website, creation\_date, expiration\_date, days, last\_run. Wartość spoza whitelisty → 422.

### Kształt odpowiedzi

**SSL** (SslReportResource): test\_id, website ({id,name,url}), valid (bool|null), issuer, organization, valid\_from, valid\_to (data wygaśnięcia), days\_left (int; ujemny po wygaśnięciu), last\_run\_at.

**WHOIS** (WhoisReportResource): test\_id, website, valid (najczęściej null — WHOIS nie klasyfikuje ważności jak SSL), registrar, creation\_date, expiration\_date, days\_left, last\_run\_at.

### Kody błędów

- 401 — brak/niepoprawny token; 403 — brak scope lub nieaktywna flaga raportu; 422 — niepoprawna wartość sort/status/expiry.

## Przykłady — API

### Certyfikaty SSL wygasające w ciągu 30 dni

curl -s "https://app.nodea.io/api/v1/reports/ssl?expiry=lt30&sort=days&direction=asc" \\ -H "Authorization: Bearer $NODEA\_TOKEN" \\ -H "Accept: application/json"

### Domeny z nieprawidłowym/nieznanym WHOIS

curl -s "https://app.nodea.io/api/v1/reports/whois?status=invalid" \\ -H "Authorization: Bearer $NODEA\_TOKEN"

## MCP — narzędzia

Dwa narzędzia read-only, ten sam scope monitoring:read i flagi per raport. W przeciwieństwie do API filtr okna to pojedynczy parametr expiring\_within\_days (wygasłe wliczane), a wynik ograniczany jest przez limit (bez paginacji stronowej). Sortowanie: zawsze rosnąco po dacie wygaśnięcia (najbliższe pierwsze), rekordy bez daty na końcu.

NarzędzieScopeTypParametryreport-sslmonitoring:readread-onlyvalidity (valid/invalid/unknown), expiring\_within\_days (0–3650), limit (1–100, domyślnie 50). report-whoismonitoring:readread-onlyvalidity, expiring\_within\_days, limit (jw.).

Wynik SSL (per wiersz): test\_id, website\_id, website\_name, domain, valid, issuer, organization, valid\_to, days\_left, last\_run + meta (total, limit). WHOIS: test\_id, website\_id, website\_name, domain, valid, registrar, creation\_date, expiration\_date, days\_left, last\_run + meta.

### Przykład — MCP (JSON-RPC)

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "report-ssl", "arguments": { "expiring\_within\_days": 30, "limit": 50 } } } { "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "report-whois", "arguments": { "validity": "invalid" } } }

## Powiązane

- [Websites — API v1 i MCP | Dokumentacja Nodea](https://nodea.pl/pl/dokumentacja-api/websites)
- [Heartbeats — API v1 i MCP | Dokumentacja Nodea](https://nodea.pl/pl/dokumentacja-api/heartbeats)
- [Status Pages — API v1 i MCP | Dokumentacja Nodea](https://nodea.pl/pl/dokumentacja-api/status-pages)

---

Wersje językowe: [en](https://nodea.io/en/api-docs/reports.md)  
Spis treści witryny: [llms.txt](https://nodea.pl/pl/llms.txt)