>_ NicAPI Dokumentation

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

  1. Einführung
  2. Domains
  3. Nameserver

Domains / Nameserver

GET Nameserver abrufen API v1

GET https://connect.nicapi.eu/api/v1/domain/nameservers

Gibt alle zugewiesenen Nameserver zurück.

Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
NAMESERVERS_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/domain/nameservers"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("domain/nameservers");

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

POST Nameserver erstellen API v1

POST https://connect.nicapi.eu/api/v1/domain/nameservers/create

Erstellt einen neuen Nameserver.

Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
NAMESERVERS_CRUD

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

Name Pflicht Typ Einschränkungen Beschreibung
nameserver Pflicht Text
muss eindeutig sein (noch nicht vergeben)
Format: /^[A-Za-z0-9.\-ßäöü]+$/
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 '{
         "nameserver": "text"
     }' \
  "https://connect.nicapi.eu/api/v1/domain/nameservers/create"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::post("domain/nameservers/create", [
    'nameserver' => 'text',
]);

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

DELETE Nameserver löschen API v1

DELETE https://connect.nicapi.eu/api/v1/domain/nameservers/delete

Löscht einen Nameserver. Eine Löschung ist nur möglich, wenn dieser bei keiner Domain mehr verwendet wird.

Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
NAMESERVERS_CRUD

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

Name Pflicht Typ Einschränkungen Beschreibung
nameserver Pflicht Identifikator: Nameserver Identifikator (servername) des Objekts „Domain Nameserver“. 
curl \
  -X DELETE \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
         "nameserver": "{nameserver}"
     }' \
  "https://connect.nicapi.eu/api/v1/domain/nameservers/delete"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::delete("domain/nameservers/delete", [
    'nameserver' => '{nameserver}',
]);

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

POST Nameserver aktualisieren API v1

POST https://connect.nicapi.eu/api/v1/domain/nameservers/refresh
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
NAMESERVERS_ACTIONS

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

Name Pflicht Typ Einschränkungen Beschreibung
nameserver Pflicht Identifikator: Nameserver Identifikator (servername) des Objekts „Domain Nameserver“. 
curl \
  -X POST \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
         "nameserver": "{nameserver}"
     }' \
  "https://connect.nicapi.eu/api/v1/domain/nameservers/refresh"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::post("domain/nameservers/refresh", [
    'nameserver' => '{nameserver}',
]);

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

GET Einzelnen Nameserver abrufen API v1

GET https://connect.nicapi.eu/api/v1/domain/nameservers/show
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
NAMESERVERS_LIST

Request-Parameter Werden als Query-Parameter übergeben.

Name Pflicht Typ Einschränkungen Beschreibung
nameserver Pflicht Identifikator: Nameserver Identifikator (servername) des Objekts „Domain Nameserver“. 
curl \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/domain/nameservers/show?nameserver=%7Bnameserver%7D"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("domain/nameservers/show", [
    'nameserver' => '{nameserver}',
]);

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

GET Nameservers: Statistics API v1

GET https://connect.nicapi.eu/api/v1/domain/nameservers/statistics
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
NAMESERVERS_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/domain/nameservers/statistics"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("domain/nameservers/statistics");

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