API i automatyzacjaAktualizacja: 02.11.2026

Netcup API: automatyzacja DNS i serwerów

API Netcup dzieli się na CCP dla DNS/domen i SCP dla serwerów. Ten poradnik pokazuje, której API użyć i jak bezpiecznie zacząć.

1. CCP API vs SCP REST API

CCP API (legacy JSON/SOAP) zarządza strefami DNS, domenami i funkcjami resellera. SCP REST API steruje serwerami: start/stop, snapshoty, ISO, sieć i więcej. DNS przez CCP, serwery przez SCP.

DNS/CloudDNS: CCP API (legacy JSON lub nowe netcup API).
Serwery: SCP REST API.
Oba API mają osobne klucze i uprawnienia.

2. Klucz API i sesja

Utwórz klucz w CCP w „Master Data → API”. Sesja powstaje przez login i wygasa po 15 minutach bezczynności. Nie commituj kluczy ani haseł.

curl -sS -X POST "https://ccp.netcup.net/run/webservice/servers/endpoint.php?JSON" \
  -H "Content-Type: application/json" \
  -d '{"action":"login","param":{"customernumber":"123456","apikey":"KEY","apipassword":"PASSWORD"}}'

Uwaga: Odpowiedź zawiera session ID. Używaj placeholderów, a prawdziwe klucze trzymaj w secret store.

3. Odczyt rekordów DNS

Użyj infoDnsRecords, aby odczytać rekordy strefy. Dokładne pola payloadu i kody błędów są w oficjalnej dokumentacji legacy API; metoda jest stabilna, ale sprawdzaj dokumentację przed każdym skryptem.

curl -sS -X POST "https://ccp.netcup.net/run/webservice/servers/endpoint.php?JSON" \
  -H "Content-Type: application/json" \
  -d '{"action":"infoDnsRecords","param":{"domainname":"example.pl","customernumber":"123456","apikey":"KEY","apisessionid":"SESSION"}}'

Uwaga: Zmiany DNS mogą natychmiast zepsuć domenę lub pocztę. Najpierw testuj na subdomenie z krótkim TTL.

4. Terraform, CLI i zabezpieczenia

Nie ma oficjalnego providera Terraform od Netcup. Użyj oficjalnego API, klientów społeczności z dokumentacji Netcup lub naszego CLI netcup-toolbox. W produkcji: rotuj klucze, planuj zmiany, eksportuj strefy DNS.