---
title: "Certyfikaty SSL — API v1 i MCP | Dokumentacja Nodea"
description: "Reference modułu Certyfikaty SSL: endpointy REST API v1 (lista, szczegóły), zakres infra:read, uprawnienie konta products, stany odnowienia, instrukcje DCV i narzędzia MCP."
url: "https://nodea.pl/pl/dokumentacja-api/ssl-certificates"
lang: "pl"
updated: "2026-10-14"
---

# Certyfikaty SSL — API v1 i MCP | Dokumentacja Nodea

> Reference modułu Certyfikaty SSL — endpointy API v1 tylko do odczytu (lista, szczegóły), zakres infra:read, statusy, odnowienia po opłaceniu okresu, instrukcje weryfikacji domeny i narzędzia MCP.

Moduł **Certyfikaty SSL** udostępnia odczyt komercyjnych certyfikatów SSL konta klienta (wystawca Sectigo przez GoGetSSL): status zamówienia, produkt, okres, daty ważności, stan odnowienia oraz — w trakcie zamówienia — instrukcje weryfikacji domeny (DCV). Zamawianie, ponowne wystawienie, zmiana metody weryfikacji i pobieranie plików (certyfikat, CA bundle, klucz prywatny) odbywają się w panelu (/app/ssl-certificates), nie przez API. Dokument opisuje warstwę REST API v1 (/api/v1/ssl-certificates) oraz narzędzia MCP z tego modułu.

## Uwierzytelnianie i zakresy (scopes)

API v1 uwierzytelnia się tokenem osobistym Passport przez nagłówek Authorization: Bearer \<token\>. Moduł jest tylko do odczytu:

- infra:read — lista i szczegóły certyfikatów.

Moduł nie ma flagi Pennant. Limit zapytań: throttle:api-v1 = 240/min na użytkownika tokenu. W MCP każde narzędzie wymaga dodatkowo zakresu transportowego mcp:use.

## Konto klienta, własność i widoczność

Certyfikaty należą do **konta klienta** (patrz [Konta klientów](https://nodea.pl/pl/dokumentacja-api/accounts)). Żądanie działa w bieżącym koncie (przypięcie tokenu → nagłówek X-Account-Id → konto domyślne). Obok scope'a tokenu wymagane jest uprawnienie konta products. Certyfikat z innego konta zwraca 404 — istnienie nie jest potwierdzane.

**Bezpieczeństwo:** odpowiedzi nigdy nie zawierają klucza prywatnego, CSR ani treści certyfikatu (PEM) — pliki pobiera się wyłącznie w panelu, a każde pobranie klucza jest odnotowywane.

## Cykl życia i płatność

Certyfikat jest zamawiany u wystawcy dopiero po opłaceniu (saldo konta albo proforma). Odnowienie u wystawcy następuje automatycznie, gdy okres rozliczeniowy obejmujący datę wygaśnięcia jest **opłacony**. Abonament wieloletni (subscription\_ends\_at późniejsze niż ważność certyfikatu) wymaga bezpłatnego ponownego wystawienia w panelu.

## API v1 — endpointy

MetodaŚcieżkaScopeOpisGET/api/v1/ssl-certificatesinfra:readLista certyfikatów bieżącego konta (najnowsze pierwsze). Parametry: status (opcjonalny filtr), per\_page (1–100, domyślnie 20), page. GET/api/v1/ssl-certificates/{id}infra:readSzczegóły jednego certyfikatu.

### Odpowiedź — certyfikat

- id, common\_name, san\_domains (lista), service\_id (usługa rozliczeniowa, nullable), created\_at.
- status — awaiting\_payment | pending\_submission | processing | active | expired | cancelled | rejected | failed | awaiting\_configuration.
- product — { id, name, validation (dv|ov|ev), is\_wildcard } lub null.
- period\_years (1–3), dcv\_method — dns | http | https | email.
- dcv — tylko w statusie processing, inaczej null: { dns?: { name, type (CNAME|TXT), value, record }, http?/https?: { link, filename, content }, email?: string, san?: \[{ name, method, status }\] }.
- valid\_from, valid\_until, subscription\_ends\_at (ISO8601, nullable), days\_until\_expiry (int|null).
- renewal — none | paid (odnowimy automatycznie) | unpaid (czeka na opłacenie okresu) | reissue (abonament wieloletni — ponowne wystawienie) | renewed (odnowienie w toku) | manual.
- certificate\_available (bool) — czy certyfikat jest gotowy do pobrania w panelu.

Lista zwraca { data: \[...\], meta: { current\_page, per\_page, total, last\_page } }, szczegóły { data: {...} }.

### Kody błędów

- 401 — brak/niepoprawny token.
- 403 — brak scope'a infra:read, brak kontekstu konta (no\_account\_context) albo brak uprawnienia products (account\_permission\_denied).
- 404 — nieznany certyfikat albo certyfikat spoza bieżącego konta.
- 422 — niepoprawna wartość status / per\_page.

## Przykłady — API

### Certyfikaty w trakcie weryfikacji

curl -s "https://app.nodea.io/api/v1/ssl-certificates?status=processing" \\ -H "Authorization: Bearer $NODEA\_TOKEN" \\ -H "Accept: application/json"

### Szczegóły certyfikatu

curl -s https://app.nodea.io/api/v1/ssl-certificates/42 \\ -H "Authorization: Bearer $NODEA\_TOKEN" \\ -H "Accept: application/json"

## MCP — narzędzia

Narzędzia MCP dzielą model uwierzytelniania, zakresów i konta z API v1. Certyfikat spoza bieżącego konta zwraca ten sam błąd co nieistniejący.

NarzędzieScopeTrybOpisssl-certificates-listinfra:readread-onlyLista certyfikatów bieżącego konta; status (opcjonalny), page, per\_page (max 50). Pola jak w odpowiedzi API, plus meta paginacji. ssl-certificate-getinfra:readread-onlyJeden certyfikat z instrukcjami weryfikacji; id (wymagany).

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

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "ssl-certificate-get", "arguments": { "id": 42 } } }

## Powiązane

- [Serwery dedykowane — API v1 i MCP | Dokumentacja Nodea](https://nodea.pl/pl/dokumentacja-api/dedicated-servers)
- [Domeny — API v1 i MCP | Dokumentacja Nodea](https://nodea.pl/pl/dokumentacja-api/domains)
- [Rozliczenia (billing) — API v1 i MCP | Dokumentacja Nodea](https://nodea.pl/pl/dokumentacja-api/billing)

---

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