Terrakom One API
Upravljajte hostingom, domenama, DNS-om, poštom i računima iz vlastitih skripti, programa i AI asistenata, uz ista pravila kao u Terrakom One.
https://www.terrakom.hr/one/api/v1OpenAPI opis (JSON)Prvi poziv
Vlasnik računa u Terrakom One otvori Korisnici i pristup → API ključevi → Novi ključ, odabere ulogu i rok te kopira ključ. Ključ se prikazuje samo tada.
# popis usluga tvrtkecurl https://www.terrakom.hr/one/api/v1/hosting \ -H "Authorization: Bearer tko_9fQ2…"# novi sandučić; lozinku stvara sustav i vraća je samo ovaj putcurl -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"], "plaćeno do", s["paid_until"])
Ključevi i uloge
Ključ smije točno ono što smije njegova uloga, iste uloge kao za osobe u Terrakom One. Ključ nema pristup upravljanju korisnicima i profilu: ne stvara druge ključeve ni prijave, ne mijenja lozinke ni privole.
| Uloga | Što ključ smije |
|---|---|
| Vlasnik računa | Sve usluge, narudžbe, predračuni, računi i upiti. |
| Hosting – odabrane usluge | Samo dodijeljene hosting usluge (pošta, DNS, web, baze, datoteke) i upiti za njih, bez računa i narudžbi. Za agencije, izvođače i skripte koje rade samo na jednom webu. |
| Računovodstvo | Predračuni i računi, PDF-ovi. |
- Rok: 30 dana, 90 dana, 1 godina ili bez roka. Opoziv vrijedi odmah.
- Vlasnik računa vidi kad je ključ zadnji put korišten.
- Ključ spremite kao tajnu (npr. varijabla okoline); nikad ga ne stavljajte u kod koji ide u repozitorij ili preglednik.
Pravila
Ograničenje broja zahtjeva
Po ključu 300 zahtjeva na sat, od toga najviše 60 izmjena (sve osim GET). Prekoračenje vraća 429; pokušajte ponovno kasnije.
Brisanje vrijedi odmah
Brisanje sandučića, baze, FTP korisnika ili DNS zapisa i zaustavljanje VPS-a izvršava se odmah, bez dodatne potvrde. AI asistent potvrdu mora tražiti od korisnika prije poziva.
Lozinke
Lozinke stvara sustav i vraća ih samo u odgovoru na stvaranje ili promjenu. Ne zapisuju se nigdje drugdje.
Narudžbe
Narudžba uvijek stvara predračun. Usluga se aktivira nakon uplate, a plaća čovjek.
Zapis radnji
Svaka izmjena na usluzi bilježi se i vidljiva je u polju actions usluge (GET /hosting/services/{obligation_id}) i u Terrakom One.
Verzije
Unutar v1 se samo dodaje (nova polja i adrese). Ono što bi slomilo postojeće integracije dolazi u v2, uz najavu.
Odgovori i greške
Odgovor je JSON s poljima success, message i data; podaci su u data (objekt ili popis). Iznimke su PDF-ovi, preuzimanje datoteke i /user/getBills. Ako radnja nije napravljena, success je false, a razlog za kupca je u message. HTTP kod je tada najčešće ipak 200, pa uvijek provjerite success.
{"success": false, "message": "Upišite ispravnu adresu i kvotu (50 MB – 50 GB).", "data": {}}| Kod | Značenje |
|---|---|
200 | Odgovor s poljima success, message i data; provjerite success. |
400 | Neispravna adresa, putanja ili radnja koja nije moguća (s porukom). |
401 | Ključ nije poslan, nije valjan, istekao je ili je opozvan. |
403 | Uloga ključa to ne smije. |
404 | Nema tog zapisa, usluga nema tu mogućnost ili je ključ ne smije vidjeti (s porukom). |
429 | Previše zahtjeva za ovaj ključ. |