Skip to main content

Benutzer anlegen

Um einen Benutzer anlegen zu können, reicht eine einzelne API abfrage aus. Das bewirkt, das der Benutzer mit den Standard Ressourcenund berechtigungen angelegt wird.
Um jetzt einen Benutzer direkt mit vorgegeben ressourcen-Limits und berechtigungen anlegen zu können, müssen wir zunächst die vorhanden Konto-vorlagen (= hosting plans) auslesen und dort die ID des gewünschten Konto-Vorlage auslesen.

Mit dieser ID können wir dan dem Benutzer die geünwschten Ressourcen /berechtigungen zuweisen.

In folgendem Beispiel wollen wir einen Neuen Benutzer "webhosting-001" anlegen und die Werte der Konto-Vorlage "HostingPlus" übertragen.


Konto-Vorlagen auslesen

Über den API-Endpunkt [GET] /hosting-plans können alle im KeYHelp angelegten Konto-vorlagen abgefragt werden. Es kann über den Endpunkt [GET] /hosting-plans/name/<NAME> auch gezielt die Daten einer Konto-Vorlage mit dem gewünschten Namen abgefragt werden, wie in den folgenden Abfragen verdeutlicht.


Anfrage
PHP 
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'https://<HOSTNAME>/api/v2/hosting-plans/name/<NAME>');
curl_setopt($curl, CURLOPT_HTTPHEADER, [
  'X-API-KEY: <API-KEY>',
  'Content-Type: application/json',
]);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($curl);

Bash 
curl -X 'GET' \
  'https://<HOSTNAME>/api/v2/hosting-plans/name/<NAME>' \
  -H 'accept: application/json' \
  -H 'X-API-Key: <API-KEY>'


Antwort

HTTP Status-Code: 200

{
  "id": 8,
  "name": "Hosting Plus",
  "resources": { ... },
  "permissions": { ... },
  "php": { ... },
  "php_fpm": { ... }
}

Benutzer anlegen

Zum Anlegen des Benutzers verwenden wir den Endpunkt [POST] /clients.
Aus der vorrangegangen Abfrage der Konto-Vorlage übernehmen wir das Feld id der Konto-vorlage und übertragen geben diese ID beim Anlegen eines Benutzers über das Feld id_hosting_plans an. 


Anfrage
PHP 
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'https://<HOSTNAME>/api/v2/hosting-plans/name/<NAME>');
curl_setopt($curl, CURLOPT_HTTPHEADER, [
  'X-API-KEY: <API-KEY>',
  'Content-Type: application/json',
]);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($curl);

Bash 
curl -X 'GET' \
  'https://<HOSTNAME>/api/v2/hosting-plans/name/<NAME>' \
  -H 'accept: application/json' \
  -H 'X-API-Key: <API-KEY>'

 

Antwort

HTTP Status-Code: 200

{
  "id": 8,
  "name": "Hosting Plus",
  "resources": { ... },
  "permissions": { ... },
  "php": { ... },
  "php_fpm": { ... }
}

Back to top