>_ NicAPI Dokumentation

REST-API von LUMASERV: Domains, DNS, SSL, Cloud-Server, IP-Adressen, Abrechnung und mehr.

  1. Einführung
  2. Datacenter
  3. IP-Adressen

Datacenter / IP-Adressen

GET Addresses: Auflisten API v1

GET https://connect.nicapi.eu/api/v1/datacenter/addresses
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST

Dieser Endpunkt benötigt neben der Authentifizierung keine weiteren Request-Parameter.

curl \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("datacenter/addresses");

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

POST Addresses: Anlegen / Ausführen API v1

POST https://connect.nicapi.eu/api/v1/datacenter/addresses
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST · ADDRESSES_ACTIONS

Request-Parameter Werden im Request-Body übergeben (JSON oder Formular-Felder).

Name Pflicht Typ Einschränkungen Beschreibung
project_uuid Optional Identifikator: Projekt
darf leer (null) sein 		Identifikator (uuid) des Objekts „Project“. 
curl \
  -X POST \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
         "project_uuid": "{project_uuid}"
     }' \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::post("datacenter/addresses", [
    'project_uuid' => '{project_uuid}',
]);

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

GET Addresses: Statistics API v1

GET https://connect.nicapi.eu/api/v1/datacenter/addresses/statistics
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST

Dieser Endpunkt benötigt neben der Authentifizierung keine weiteren Request-Parameter.

curl \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/statistics"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("datacenter/addresses/statistics");

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

GET Addresses: Traffic API v1

GET https://connect.nicapi.eu/api/v1/datacenter/addresses/traffic
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST

Request-Parameter Werden als Query-Parameter übergeben.

Name Pflicht Typ Einschränkungen Beschreibung
addresses[] Optional IP-Adresse
interval Pflicht Auswahl
daily monthly
start Pflicht Datum (YYYY-MM-DD)
end Pflicht Datum (YYYY-MM-DD)
result_type Pflicht Auswahl
single sum 
curl \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/traffic?interval=daily&start=2026-01-31&end=2026-01-31&result_type=single"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("datacenter/addresses/traffic", [
    'interval' => 'daily',
    'start' => '2026-01-31',
    'end' => '2026-01-31',
    'result_type' => 'single',
]);

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

GET Addresses: Einzeln abrufen API v1

GET https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ip_address Pflicht Identifikator: IP-Adresse Identifikator (address_plain) des Objekts „Address“, Teil des Pfads.

Dieser Endpunkt benötigt neben der Authentifizierung keine weiteren Request-Parameter.

curl \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("datacenter/addresses/{ip_address}");

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

PUT Addresses: Ändern API v1

PUT https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST · ADDRESSES_ACTIONS

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ip_address Pflicht Identifikator: IP-Adresse Identifikator (address_plain) des Objekts „Address“, Teil des Pfads.

Request-Parameter Werden im Request-Body übergeben (JSON oder Formular-Felder).

Name Pflicht Typ Einschränkungen Beschreibung
rdns Optional Text
darf leer (null) sein
Format: /^([A-Za-z0-9-]{1,63}\.){0,10}[A-Za-z0-9]{2,63}$/
reserved Optional Text
darf leer (null) sein
höchstens 255 Zeichen
 
curl \
  -X PUT \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
         "rdns": "text",
         "reserved": "text"
     }' \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::put("datacenter/addresses/{ip_address}", [
    'rdns' => 'text',
    'reserved' => 'text',
]);

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

DELETE Addresses: Löschen API v1

DELETE https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST · ADDRESSES_ACTIONS

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ip_address Pflicht Identifikator: IP-Adresse Identifikator (address_plain) des Objekts „Address“, Teil des Pfads.

Dieser Endpunkt benötigt neben der Authentifizierung keine weiteren Request-Parameter.

curl \
  -X DELETE \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::delete("datacenter/addresses/{ip_address}");

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

POST Addresses: Blackhole API v1

POST https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/blackhole
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST · ADDRESSES_BLACKHOLES

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ip_address Pflicht Identifikator: IP-Adresse Identifikator (address_plain) des Objekts „Address“, Teil des Pfads.

Dieser Endpunkt benötigt neben der Authentifizierung keine weiteren Request-Parameter.

curl \
  -X POST \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/blackhole"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::post("datacenter/addresses/{ip_address}/blackhole");

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

DELETE Addresses: Blackhole API v1

DELETE https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/blackhole
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST · ADDRESSES_BLACKHOLES

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ip_address Pflicht Identifikator: IP-Adresse Identifikator (address_plain) des Objekts „Address“, Teil des Pfads.

Dieser Endpunkt benötigt neben der Authentifizierung keine weiteren Request-Parameter.

curl \
  -X DELETE \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/blackhole"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::delete("datacenter/addresses/{ip_address}/blackhole");

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

GET Addresses: Graph API v1

GET https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/graph
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ip_address Pflicht Identifikator: IP-Adresse Identifikator (address_plain) des Objekts „Address“, Teil des Pfads.

Request-Parameter Werden als Query-Parameter übergeben.

Name Pflicht Typ Einschränkungen Beschreibung
start Pflicht Datum (YYYY-MM-DD)
end Pflicht Datum (YYYY-MM-DD) 
curl \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/graph?start=2026-01-31&end=2026-01-31"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("datacenter/addresses/{ip_address}/graph", [
    'start' => '2026-01-31',
    'end' => '2026-01-31',
]);

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

POST Addresses: Rdns Create API v1

POST https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/rdns/create
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST · ADDRESSES_ACTIONS

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ip_address Pflicht Identifikator: IP-Adresse Identifikator (address_plain) des Objekts „Address“, Teil des Pfads.

Request-Parameter Werden im Request-Body übergeben (JSON oder Formular-Felder).

Name Pflicht Typ Einschränkungen Beschreibung
rdns Optional Text
Format: /^([A-Za-z0-9-]{1,63}\.){0,10}[A-Za-z0-9]{2,63}$/
 
curl \
  -X POST \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
         "rdns": "text"
     }' \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/rdns/create"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::post("datacenter/addresses/{ip_address}/rdns/create", [
    'rdns' => 'text',
]);

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

DELETE Addresses: Rdns Delete API v1

DELETE https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/rdns/delete
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST · ADDRESSES_ACTIONS

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ip_address Pflicht Identifikator: IP-Adresse Identifikator (address_plain) des Objekts „Address“, Teil des Pfads.

Dieser Endpunkt benötigt neben der Authentifizierung keine weiteren Request-Parameter.

curl \
  -X DELETE \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/rdns/delete"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::delete("datacenter/addresses/{ip_address}/rdns/delete");

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

POST Addresses: Reserve API v1

POST https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/reserve
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST · ADDRESSES_ACTIONS

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ip_address Pflicht Identifikator: IP-Adresse Identifikator (address_plain) des Objekts „Address“, Teil des Pfads.

Request-Parameter Werden im Request-Body übergeben (JSON oder Formular-Felder).

Name Pflicht Typ Einschränkungen Beschreibung
reason Pflicht Text
höchstens 255 Zeichen
 
curl \
  -X POST \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
         "reason": "text"
     }' \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/reserve"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::post("datacenter/addresses/{ip_address}/reserve", [
    'reason' => 'text',
]);

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

GET Addresses: Traffic API v1

GET https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/traffic
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ip_address Pflicht Identifikator: IP-Adresse Identifikator (address_plain) des Objekts „Address“, Teil des Pfads.

Dieser Endpunkt benötigt neben der Authentifizierung keine weiteren Request-Parameter.

curl \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/traffic"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("datacenter/addresses/{ip_address}/traffic");

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

POST Addresses: Unreserve API v1

POST https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/unreserve
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
ADDRESSES_LIST · ADDRESSES_ACTIONS

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ip_address Pflicht Identifikator: IP-Adresse Identifikator (address_plain) des Objekts „Address“, Teil des Pfads.

Dieser Endpunkt benötigt neben der Authentifizierung keine weiteren Request-Parameter.

curl \
  -X POST \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/addresses/{ip_address}/unreserve"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::post("datacenter/addresses/{ip_address}/unreserve");

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}