API та автоматизаціяОновлено: 02.11.2026

Netcup API: автоматизація DNS і серверів

API Netcup поділяється на CCP для DNS/доменів і SCP для серверів. Цей посібник показує, яке API використовувати й як безпечно почати.

1. CCP API vs SCP REST API

CCP API (legacy JSON/SOAP) керує DNS-зонами, доменами й функціями реселера. SCP REST API керує серверами: start/stop, снапшоти, ISO, мережа тощо. DNS — через CCP, сервери — через SCP.

DNS/CloudDNS: CCP API (legacy JSON або новий netcup API).
Сервери: SCP REST API.
Обидва API мають окремі ключі й права.

2. Ключ API і сесія

Створіть ключ у CCP у «Master Data → API». Сесія створюється через login і завершується після 15 хвилин бездіяльності. Не комітьте ключі та паролі.

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

Примітка: Відповідь містить session ID. Використовуйте placeholders, а справжні ключі зберігайте в secret store.

3. Читання DNS-записів

Використовуйте infoDnsRecords, щоб прочитати записи зони. Точні поля payload і коди помилок — в офіційній документації legacy API; метод стабільний, але перевіряйте документацію перед кожним скриптом.

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

Примітка: Зміни DNS можуть одразу зламати домен або пошту. Спочатку тестуйте на субдомені з коротким TTL.

4. Terraform, CLI і запобіжники

Офіційного Terraform-провайдера від Netcup немає. Використовуйте офіційний API, клієнти спільноти з документації Netcup або наш CLI netcup-toolbox. Для продакшену: ротуйте ключі, плануйте зміни, експортуйте DNS-зони.