Startseite/Für Entwickler

Terrakom One API

Verwalten Sie Hosting, Domains, DNS, E-Mail und Rechnungen aus eigenen Skripten, Programmen und KI-Assistenten, mit denselben Regeln wie in Terrakom One.

https://www.terrakom.hr/one/api/v1OpenAPI-Beschreibung (JSON)

Erste Anfrage

Der Kontoinhaber öffnet in Terrakom One Benutzer und Zugriff → API-Schlüssel → Neuer Schlüssel, wählt Rolle und Laufzeit und kopiert den Schlüssel. Der Schlüssel wird nur dieses eine Mal angezeigt.

# Dienste des Unternehmens auflistencurl https://www.terrakom.hr/one/api/v1/hosting \  -H "Authorization: Bearer tko_9fQ2…"# neues Postfach; das System erzeugt das Passwort und gibt es nur dieses eine Mal zurückcurl -X POST https://www.terrakom.hr/one/api/v1/hosting/services/281475/mail/mailboxes \  -H "Authorization: Bearer tko_9fQ2…" -H "Content-Type: application/json" \  -d '{"local_part": "ana", "domain": "firma.hr", "quota_mb": 2048}'

# Pythonimport requestsapi = requests.Session()api.headers["Authorization"] = "Bearer tko_9fQ2…"for s in api.get("https://www.terrakom.hr/one/api/v1/hosting").json()["data"]["services"]:    print(s["domain"], s["name"], "bezahlt bis", s["paid_until"])

Schlüssel und Rollen

Ein Schlüssel darf genau das, was seine Rolle erlaubt; es sind dieselben Rollen wie für Personen in Terrakom One. Ein Schlüssel hat keinen Zugriff auf die Benutzer- und Profilverwaltung: Er erstellt keine weiteren Schlüssel oder Anmeldungen und ändert weder Passwörter noch Einwilligungen.

Rolle	Was der Schlüssel darf
Kontoinhaber	Alle Dienste, Bestellungen, Proforma-Rechnungen, Rechnungen und Supportanfragen.
Hosting – ausgewählte Dienste	Nur die zugewiesenen Hosting-Dienste (E-Mail, DNS, Web, Datenbanken, Dateien) und Supportanfragen dazu, ohne Rechnungen und Bestellungen. Für Agenturen, Auftragnehmer und Skripte, die nur an einer Website arbeiten.
Buchhaltung	Proforma-Rechnungen und Rechnungen, PDFs.

Laufzeit: 30 Tage, 90 Tage, 1 Jahr oder unbegrenzt. Ein Widerruf gilt sofort.
Der Kontoinhaber sieht, wann der Schlüssel zuletzt verwendet wurde.
Speichern Sie den Schlüssel als Geheimnis (z. B. in einer Umgebungsvariablen); legen Sie ihn nie in Code ab, der in ein Repository oder in den Browser gelangt.

Regeln

Anfragelimits

300 Anfragen pro Stunde und Schlüssel, davon höchstens 60 Änderungen (alles außer GET). Bei Überschreitung kommt 429 zurück; versuchen Sie es später erneut.

Löschen gilt sofort

Das Löschen eines Postfachs, einer Datenbank, eines FTP-Benutzers oder DNS-Eintrags sowie das Anhalten eines VPS werden sofort ausgeführt, ohne weitere Bestätigung. Ein KI-Assistent muss vor dem Aufruf die Bestätigung des Benutzers einholen.

Passwörter

Passwörter erzeugt das System; sie werden nur in der Antwort auf das Anlegen oder Ändern zurückgegeben und nirgends sonst gespeichert.

Bestellungen

Eine Bestellung erzeugt immer eine Proforma-Rechnung. Der Dienst wird nach der Zahlung aktiviert, und bezahlt wird von einem Menschen.

Aktivitätsprotokoll

Jede Änderung an einem Dienst wird protokolliert und ist im Feld actions des Dienstes (GET /hosting/services/{obligation_id}) und in Terrakom One sichtbar.

Versionen

Innerhalb von v1 kommt nur Neues hinzu (neue Felder und Adressen). Was bestehende Integrationen brechen würde, kommt mit Ankündigung in v2.

Antworten und Fehler

Die Antwort ist JSON mit den Feldern success, message und data; die Daten stehen in data (Objekt oder Liste). Ausnahmen sind PDFs, Dateidownloads und /user/getBills. Wurde die Aktion nicht ausgeführt, ist success gleich false, und der Grund für den Kunden steht in message. Der HTTP-Code ist dann meist trotzdem 200, prüfen Sie daher immer success.

{"success": false, "message": "Upišite ispravnu adresu i kvotu (50 MB – 50 GB).", "data": {}}

Code	Bedeutung
`200`	Antwort mit den Feldern success, message und data; prüfen Sie `success`.
`400`	Ungültige Adresse, ungültiger Pfad oder nicht mögliche Aktion (mit Meldung).
`401`	Der Schlüssel wurde nicht gesendet, ist ungültig, abgelaufen oder widerrufen.
`403`	Die Rolle des Schlüssels erlaubt das nicht.
`404`	Kein solcher Eintrag, der Dienst hat diese Funktion nicht oder der Schlüssel darf ihn nicht sehen (mit Meldung).
`429`	Zu viele Anfragen für diesen Schlüssel.