API & AutomatisierungStand: 02.11.2026

Netcup API: DNS und Server automatisieren

Die Netcup-API ist zweigeteilt: CCP für DNS/Domains und SCP für Server. Dieser Guide zeigt, welche API wofür da ist und wie du sicher startest.

1. CCP-API vs. SCP-REST-API

Die CCP-API (Legacy JSON/SOAP) verwaltet DNS-Zonen, Domains und Reseller-Funktionen. Die SCP-REST-API steuert Server: Start/Stop, Snapshots, ISO, Netzwerk und mehr. Für DNS nimmst du die CCP-API; für Server-Automation die SCP-REST-API.

DNS/CloudDNS: CCP-API (Legacy JSON oder neue netcup API).
Server: SCP-REST-API.
Beide APIs brauchen eigene Keys und Rechte.

2. API-Key und Session

Erstelle den Key im CCP unter „Master Data → API“. Die Session entsteht per login und läuft nach 15 Minuten Inaktivität ab. Keys und Passwörter gehören nie ins Repository.

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"}}'

Hinweis: Die Response enthält eine Session-ID. Verwende Platzhalter und speichere echte Keys nur in einem Secret Store.

3. DNS-Records lesen

Mit infoDnsRecords liest du die Records einer Zone. Die genauen Payload-Felder und Fehlercodes stehen in der offiziellen Legacy-API-Dokumentation; die Methode ist stabil, aber prüfe die Doku vor jedem Skript.

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.com","customernumber":"123456","apikey":"KEY","apisessionid":"SESSION"}}'

Hinweis: Änderungen an DNS-Records können deine Domain oder Mail sofort brechen. Teste zuerst mit einer Subdomain und kurzer TTL.

4. Terraform, CLI und Guardrails

Es gibt keinen offiziellen Terraform-Provider von Netcup. Nutze die offizielle API, die Community-Clients aus der Netcup-Doku oder unser CLI aus dem netcup-toolbox-Repo. Für Produktion: Keys rotieren, Änderungen planen, DNS-Exports sichern.

API-Keys mit minimalen Rechten und eigener Beschreibung.
Änderungen zuerst als Dry-Run/Plan, dann anwenden.
DNS-Zonen vor Bulk-Änderungen exportieren.
Logs und API-Antworten auf Fehlercodes prüfen.

Offizielle Quellen

netcup APIAktuelle API-Dokumentation.Legacy APICCP JSON/SOAP, DNS und Domains.SCP REST APIServer-Automation.netcup-toolboxCLI-Beispiele und DNS-Client.

Passende Tarife

VPS 1000 G12.5

Bestseller

VPS • G12.5

1 Monat gratis

14,50 €/ Monatinkl. 19 % MwSt.12 Monate Laufzeit

4 vCores (x86) · 8 GB RAM · 128 GB SSD · 2.5 Gbit/s

GB6: 1.720/4.650 · Steal: 1,2 %

Aktuellen Code laden…

RS 1000 G12.5

Bestseller

Root-Server • G12.5

2 Monate gratis

21,73 €/ Monatinkl. 19 % MwSt.12 Monate Laufzeit

4 dedizierte Kerne (AMD EPYC 9645) · 8 GB RAM · 128 GB NVMe · 2.5 Gbit/s

GB6: 2.290/7.559 · Steal: 0,0 %

Aktuellen Code laden…

Häufige Fragen

Welche API für CloudDNS?

Für CloudDNS gibt es die neue netcup API; die Legacy-CCP-API bleibt für klassische DNS-Zonen. Prüfe die offizielle Doku, welche Methode zu deinem Domaintyp passt.

Quelle

Wie lange ist die API-Session gültig?

Die Legacy-CCP-Session läuft nach 15 Minuten Inaktivität ab. Ein logout beendet sie sofort; Skripte sollten die Session nicht dauerhaft speichern.

Quelle

Kann ich Server über die CCP-API neu starten?

Nein, Server-Aktionen laufen über die SCP-REST-API. Die CCP-API ist für DNS, Domains und Reseller-Funktionen gedacht.

Quelle