KeyHelp API  [GELÖST]

select name from me;
Posts: 588
Joined: Tue 9. Feb 2016, 16:44

Re: KeyHelp API

Post by select name from me; »

Alexander wrote: Tue 20. Aug 2019, 09:49 Jetzt hat ja Christian in der Zwischenzeit geschrieben, da gehe ich später noch drauf ein - bist nicht vergessen ;).
Ach und MLAN hab ich bei meiner Antwort auch übersehen. Kommt im nächsten Post.
Kein Thema. Wir haben ja Geduld. :mrgreen:
Viele Grüße, Christian
User avatar
Enigma
Posts: 258
Joined: Thu 2. Aug 2018, 19:18

Re: KeyHelp API

Post by Enigma »

Alexander wrote: Tue 20. Aug 2019, 09:49 Ersteinmal vielen Dank für das Feedback soweit.

Tobi wrote: Mon 19. Aug 2019, 18:52 Ich habe gesehen, dass man neue Kunden mit einem Hostingplan anlegen kann. Dazu ist mir aufgefallen, dass der Hosting Plan mit Namen benannt sein muss. Währe hier nicht die ID "robuster"?
Habs notiert kommt noch :).

[...]

Enigma wrote: Mon 19. Aug 2019, 20:27 Da nach Rechtschreibfehlern gefragt wurde: Die API selbst ist, wenn ich nichts übersehen habe, fehlerfrei. In die Beschreibungen haben sich ein paar kleine Fehler eingeschlichen (einer mehrfach, nämlich "hosting-plan" - hier steht im Englischen kein Bindestrich):
-> Korrigiert, Danke!
Enigma wrote: Mon 19. Aug 2019, 20:27 [*]Bei GET /domains, GET /emails etc. werden jeweils ein UTF-8-Name und ein Punycode-Name zurückgegeben. Es sollte bei den POST-Methoden zumindest angegeben werden, welcher Wert angegeben werden muss. Dies selbst angeben zu können, wäre natürlich auch eine Option.
-> Es wird bei POST für die Variable "domain" utf8 sowie punycode akzeptiert. Habe das in als Beschreibung nun ergänzt.
Enigma wrote: Mon 19. Aug 2019, 20:27 [*]Bei POST ​/emails vermisse ich zumindest die Angabe der Größe, der Weiterleitungs-Adressen und ob es sich um einen reinen Forwarder handelt.
-> Die Werte standen in den Beispieldaten nicht dabei. Das ist nun ergänzt. Das Feld: "store_forwarded_emails" gibt Aufschluss darüber, ob es ein reiner Forwarder ist oder nicht.
Enigma wrote: Mon 19. Aug 2019, 20:27 [*]PUT ​/emails​/{id}: Werden hier zukünftig weitere Änderungsmöglichkeiten hinzugefügt? Funktioniert das Hinzufügen von Aliassen unmittelbar nach dem Anlegen einer E-Mail-Adresse oder erst, wenn der Cronjob gelaufen ist? Falls Letzteres, sollte auch das direkt beim Anlegen möglich sein.
-> Wie beim Punkt weiter oben, die Beispieldaten waren nicht vollständig, funktioniert also alles gleich schon beim Anlegen.

christian.john wrote: Tue 20. Aug 2019, 08:42 1. PHP-Versionen bei den Domains setzen kann.
-> Werde ich noch ergänzen.

Klasse, vielen Dank! :D

Für den Fall, dass sich jemand wundert: Die Änderungen sind in die Beschreibung der API-Version 1.0.1 eingeflossen.

Gruß
Jan
This message has been ROT-13 encrypted twice for higher security.
User avatar
Tobi
Community Moderator
Posts: 3230
Joined: Thu 5. Jan 2017, 13:24

Re: KeyHelp API

Post by Tobi »

Alexander wrote: Tue 20. Aug 2019, 09:49
Aufgrund logischer Trennung würde das eher mit zwei Requests an die API lösen wollen. Das heißt im ersten Request legt man einen Benutzer an (erhält dann als Antwort die ID des Client zurück) und im zweiten Request legt man eine Domain an und gibt beim Request 'id_owner' = ID des eben angelegten Clienten an.
Ja, das war auch mein erster Gedanke. Allerdings bleibt doch da eine "Wartezeit" bis das auf dem Server "durch" ist.
Oder läuft die API nicht über den mastercron?
Alexander wrote: Tue 20. Aug 2019, 09:49
Tobi wrote: Mon 19. Aug 2019, 18:52 Ebenso wäre eine Prüfung auf "Domainnamen bereits vergeben" mit gleichzeitiger Auth-Code Übermittlung auch _sehr_ wichtig.
Das wäre mit einem Request an GET/domains/domain/meine-tolle-domain.de möglich. Wenn 404 als Response-Code dann gibts sie nicht.

-> Falls ich dich falsch verstanden hab, korrigiere mich gern nochmal :)
Jupp, falsch verstanden ;)
Ich meinte eine WHOIS-Prüfung.

Nur so kann man einen realen Bestell-Ablauf nachbilden.
Kunde wählt Hosting-Plan aus, gibt Domainnamen ein, Hinweis "bereits vergeben" poppt auf, Kunde ergänzt Auth-Code für Domaintransfer.
Gruß,
Tobi


-----------------------------
wewoco.de
Das Forum für Reseller, Digital-Agenturen, Bildschirmarbeiter und Mäuseschubser
User avatar
mhagge
Community Moderator
Posts: 563
Joined: Wed 8. Aug 2018, 15:19

Re: KeyHelp API

Post by mhagge »

Nur so kann man einen realen Bestell-Ablauf nachbilden.
Kunde wählt Hosting-Plan aus, gibt Domainnamen ein, Hinweis "bereits vergeben" poppt auf, Kunde ergänzt Auth-Code für Domaintransfer.
Wobei doch über Keyhelp eh keine Domains bestellt werden können? Das machst Du doch entweder über Keyweb oder einen anderen Domainregistrar des vertrauens. In Keyhelp wird die Domain doch letztendlich nur für die Serverdienste (Apache, Postfix etc.) angelegt, ob sie denn wirklich registriert wird (und dann auch noch auf den Server zeigt) ist eine ganz andere Geschichte
User avatar
Tobi
Community Moderator
Posts: 3230
Joined: Thu 5. Jan 2017, 13:24

Re: KeyHelp API

Post by Tobi »

Richtig.
Die Domain ansich kann nicht bestellt werden.
Von der Bestellogik würde ich das aber schon zusammenhängend sehen.

Dann muss ich mir was ausdenken...
Gruß,
Tobi


-----------------------------
wewoco.de
Das Forum für Reseller, Digital-Agenturen, Bildschirmarbeiter und Mäuseschubser
User avatar
Alexander
Keyweb AG
Posts: 4448
Joined: Wed 20. Jan 2016, 02:23

Re: KeyHelp API

Post by Alexander »

Wie vor ein paar Tagen versprochen hier jetzt die Bezugnahme zu den anderen Posts.

select name from me; wrote: Tue 20. Aug 2019, 09:05 /server
utilization ist praktisch für ein eigenes Monitoring. Wie verhält sich disk_space, wenn mehrere Platten verbaut sind?
Würde es hier Sinn machen, die Auslastung der inoden mit auszugeben (df - i)? Je nach Anwendungsfall ist manchmal die Platte nicht voll, aber die inoden komplett belegt.
Das Verhalten wäre aktuell genauso, wie es auch innerhalb der KeyHelp UI ist. Untersucht wird nur die Partition, auf dem die Home-Verzeichnisse der Clients liegen.
Informationen zu den frei / belegten Inodes nun ergänzt (diese Angabe steht vorerst nur via API zur Verfügung, kommt also erstmal nicht in die KeyHelp UI).

select name from me; wrote: Tue 20. Aug 2019, 09:05 /domains
Für mich wäre es wichtig, bestehende SSL Zertifikate zu wählen.
Domains können nun Zertifikats-IDs zugewiesen werden, passend dazu gibt es nun auch einen Endpunkt für Zertifikate, wo man die Zertifikate abfragen / aktualisieren / ... kann.

select name from me; wrote: Tue 20. Aug 2019, 09:05 A-Priorität: Für mich wäre es auch wichtig Datenbanken und FTP Accounts anlegen zu können.
Endpunkt für Datenbanken und FTP-Accounts hinzugefügt. Damit wäre das dann möglich.

select name from me; wrote: Tue 20. Aug 2019, 09:05 B-Priorität: Wenn man die Einstellungen, die man auf einem neuen Server vornimmt, auch per API ausführen könnte, wäre das super.
Das würde ich auf ein späteres Release verschieben.

MLan wrote: Mon 19. Aug 2019, 18:11 Zu DKIM und DNS hab ich nichts gefunden.
Wäre sicherlich auch ganz brauchbar.
Der DKIM Record wird nun mit zurückgegeben.
Für DNS wird es erstmal nur möglich sein DNS zu aktivieren oder zu deaktivieren.

---

Allgemein gabs noch ein paar Updates, so das ich im Moment bei API-Version 1.0.6 bin (https://app.swaggerhub.com/apis-docs/keyhelp/api/)


Zum generellen Entwicklungsstand: Bis auf die einzelnen Endpunkte ist die API soweit fertig. Sprich, alles funktioniert soweit (Routing, API-KEY-Verwaltung / Authentifizierung / Diverse Sicherheitsmaßnahmen / ...), jetzt muss es nur noch mit Leben gefüllt werden. Die ersten Endpunkte sind annähernd fertig gestellt und die Weiteren folgen in den kommenden Tagen. Wenn alles nach Plan läuft, kann zum Ende kommender Woche getestet werden (hierzu würde ich wieder gern auf den ein oder anderen Freiwilligen zurück greifen).
Mit freundlichen Grüßen / Best regards
Alexander Mahr

**************************************************************
Keyweb AG - Die Hosting Marke
Neuwerkstr. 45/46, 99084 Erfurt / Germany
http://www.keyweb.de - http://www.keyhelp.de
**************************************************************
select name from me;
Posts: 588
Joined: Tue 9. Feb 2016, 16:44

Re: KeyHelp API

Post by select name from me; »

Alexander wrote: Wed 11. Sep 2019, 14:34 Wie vor ein paar Tagen versprochen hier jetzt die Bezugnahme zu den anderen Posts.
...
Super, vielen Dank. 👍
Viele Grüße, Christian
User avatar
Enigma
Posts: 258
Joined: Thu 2. Aug 2018, 19:18

Re: KeyHelp API

Post by Enigma »

Alexander wrote: Wed 11. Sep 2019, 14:34 Zum generellen Entwicklungsstand: Bis auf die einzelnen Endpunkte ist die API soweit fertig. Sprich, alles funktioniert soweit (Routing, API-KEY-Verwaltung / Authentifizierung / Diverse Sicherheitsmaßnahmen / ...), jetzt muss es nur noch mit Leben gefüllt werden. Die ersten Endpunkte sind annähernd fertig gestellt und die Weiteren folgen in den kommenden Tagen. Wenn alles nach Plan läuft, kann zum Ende kommender Woche getestet werden (hierzu würde ich wieder gern auf den ein oder anderen Freiwilligen zurück greifen).

Klingt klasse, ich bin schon sehr gespannt! :)

Ich würde auch furchtbar gern testen, bin aber noch nicht ganz sicher, ob ich die Zeit finde. Das Interesse ist aber definitiv vorhanden!

Gruß
Jan
This message has been ROT-13 encrypted twice for higher security.
User avatar
[headcrash]
Posts: 27
Joined: Wed 18. Jul 2018, 17:09

Re: KeyHelp API

Post by [headcrash] »

Erst mal ein dickes Danke auch von uns, sobald hier etwas Ruhe eingekehrt ist, werden wir uns auf jeden Fall intensiv damit beschäftigen.

Rüdiger
derFu
Posts: 99
Joined: Sat 28. Apr 2018, 18:46

Re: KeyHelp API

Post by derFu »

im Oktober wird die neue Version ... KeyHelp® ... neues API (Application Programming Interface) Feature ....
Och böh... erst im Oktober? 🙃

Nein, ernsthaft: super, super, vielen Dank!
User avatar
Alexander
Keyweb AG
Posts: 4448
Joined: Wed 20. Jan 2016, 02:23

Re: KeyHelp API

Post by Alexander »

Interessierte Tester dürfen sich gern per PM bei mir melden, Ihr erhaltet darauf hin im Laufe des Tages die Zugangsdaten für die Testserver.
Besten dank vorab!

Enigma + select name from me, Ihr erhaltet die Daten einfach ungefragt ;).
Mit freundlichen Grüßen / Best regards
Alexander Mahr

**************************************************************
Keyweb AG - Die Hosting Marke
Neuwerkstr. 45/46, 99084 Erfurt / Germany
http://www.keyweb.de - http://www.keyhelp.de
**************************************************************
User avatar
Enigma
Posts: 258
Joined: Thu 2. Aug 2018, 19:18

Re: KeyHelp API

Post by Enigma »

Alexander wrote: Fri 27. Sep 2019, 06:54 Enigma + select name from me, Ihr erhaltet die Daten einfach ungefragt ;).
Cool 8-), herzlichen Dank!

Der Testzeitraum steht bestimmt in der Mail, oder? Ich bin nämlich tatsächlich gerade sehr eingespannt (noch eine knappe Woche)...

Gruß
Jan
This message has been ROT-13 encrypted twice for higher security.
User avatar
Alexander
Keyweb AG
Posts: 4448
Joined: Wed 20. Jan 2016, 02:23

Re: KeyHelp API

Post by Alexander »

Kein Stress - Testzeitraum ist in jedem Fall noch bis (ggf. einschließlich) 42. KW, da ich in Kürze auch erstmal für ca. 2 Wochen nicht mehr im Haus bin.
Mit freundlichen Grüßen / Best regards
Alexander Mahr

**************************************************************
Keyweb AG - Die Hosting Marke
Neuwerkstr. 45/46, 99084 Erfurt / Germany
http://www.keyweb.de - http://www.keyhelp.de
**************************************************************
User avatar
Enigma
Posts: 258
Joined: Thu 2. Aug 2018, 19:18

Re: KeyHelp API

Post by Enigma »

Alexander wrote: Fri 27. Sep 2019, 07:23 Kein Stress - Testzeitraum ist in jedem Fall noch bis (ggf. einschließlich) 42. KW, da ich in Kürze auch erstmal für ca. 2 Wochen nicht mehr im Haus bin.
Klasse - dass der Zeitraum etwas länger ist, nicht dass Du weg bist! ;) Solltest Du allerdings Urlaub haben, ist er Dir natürlich von Herzen gegönnt. :D

Gruß
Jan
This message has been ROT-13 encrypted twice for higher security.
select name from me;
Posts: 588
Joined: Tue 9. Feb 2016, 16:44

Re: KeyHelp API

Post by select name from me; »

Alexander wrote: Fri 27. Sep 2019, 06:54 Interessierte Tester dürfen sich gern per PM bei mir melden, Ihr erhaltet darauf hin im Laufe des Tages die Zugangsdaten für die Testserver.
Besten dank vorab!

Enigma + select name from me, Ihr erhaltet die Daten einfach ungefragt ;).
Super, vielen Dank. Auch der Zeitraum ist klasse. Ich bin zwischendrin auch mal kurz weg.

Nachtrag: Schönen Urlaub :)
Viele Grüße, Christian
Locked