>_ NicAPI Dokumentation

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

  1. Einführung
  2. Support

Support / Tickets

GET Tickets abrufen API v1

GET https://connect.nicapi.eu/api/v1/support/tickets

Gibt alle zugewiesenen Tickets zurück.

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

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("support/tickets");

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

POST Ticket erstellen API v1

POST https://connect.nicapi.eu/api/v1/support/tickets/create
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
TICKETS_OPEN

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

Name Pflicht Typ Einschränkungen Beschreibung
title Pflicht Text
höchstens 255 Zeichen
message Pflicht Text
email Optional E-Mail-Adresse
priority Pflicht Auswahl
ASAP HIGH MEDIUM LOW MEDIUM 
curl \
  -X POST \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
         "title": "text",
         "message": "text",
         "priority": "ASAP"
     }' \
  "https://connect.nicapi.eu/api/v1/support/tickets/create"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::post("support/tickets/create", [
    'title' => 'text',
    'message' => 'text',
    'priority' => 'ASAP',
]);

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

GET Abteilungen abrufen API v1

GET https://connect.nicapi.eu/api/v1/support/tickets/groups

Gibt alle möglichen Ticket-Empfänger zurück.

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

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("support/tickets/groups");

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

GET Tickets: Statistics API v1

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

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("support/tickets/statistics");

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

GET Einzelnes Ticket abrufen API v1

GET https://connect.nicapi.eu/api/v1/support/tickets/{ticket}

Gibt Informationen zu einem einzelnen Ticket zurück.

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

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ticket Pflicht Identifikator: Ticket Identifikator (id) des Objekts „Ticket“, 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/support/tickets/{ticket}"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("support/tickets/{ticket}");

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

POST Ticket-Antwort erstellen API v1

POST https://connect.nicapi.eu/api/v1/support/tickets/{ticket}/answer

Erstellt eine Antwort auf ein Ticket.

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

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ticket Pflicht Identifikator: Ticket Identifikator (id) des Objekts „Ticket“, 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/support/tickets/{ticket}/answer"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::post("support/tickets/{ticket}/answer");

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

GET Tickets: File API v1

GET https://connect.nicapi.eu/api/v1/support/tickets/{ticket}/file
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
TICKETS_LIST

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ticket Pflicht Identifikator: Ticket Identifikator (id) des Objekts „Ticket“, 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/support/tickets/{ticket}/file"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("support/tickets/{ticket}/file");

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