Terrakom One API
Upravljajte gostovanjem, domenami, DNS-om, pošto in računi iz lastnih skript, programov in pomočnikov AI, po enakih pravilih kot v Terrakom One.
https://www.terrakom.hr/one/api/v1Opis OpenAPI (JSON)Prvi klic
Lastnik računa v Terrakom One odpre Uporabniki in dostop → Ključi API → Nov ključ, izbere vlogo in rok veljavnosti ter kopira ključ. Ključ se prikaže samo takrat.
# seznam storitev podjetjacurl https://www.terrakom.hr/one/api/v1/hosting \ -H "Authorization: Bearer tko_9fQ2…"# nov poštni predal; geslo ustvari sistem in ga vrne samo tokratcurl -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čano do", s["paid_until"])
Ključi in vloge
Ključ sme natanko to, kar sme njegova vloga, z enakimi vlogami kot za osebe v Terrakom One. Ključ nima dostopa do upravljanja uporabnikov in profila: ne ustvarja drugih ključev ali prijav in ne spreminja gesel ali privolitev.
| Vloga | Kaj ključ sme |
|---|---|
| Lastnik računa | Vse storitve, naročila, predračuni, računi in zahtevki. |
| Gostovanje – izbrane storitve | Samo dodeljene storitve gostovanja (pošta, DNS, splet, baze podatkov, datoteke) in zahtevki zanje, brez računov in naročil. Za agencije, izvajalce in skripte, ki delajo samo na enem spletnem mestu. |
| Računovodstvo | Predračuni in računi, PDF-ji. |
- Rok veljavnosti: 30 dni, 90 dni, 1 leto ali brez roka. Preklic velja takoj.
- Lastnik računa vidi, kdaj je bil ključ nazadnje uporabljen.
- Ključ shranite kot skrivnost (npr. v spremenljivki okolja); nikoli ga ne vstavljajte v kodo, ki gre v repozitorij ali brskalnik.
Pravila
Omejitev števila zahtev
Na ključ 300 zahtev na uro, od tega največ 60 sprememb (vse razen GET). Prekoračitev vrne 429; poskusite znova pozneje.
Brisanje velja takoj
Brisanje poštnega predala, baze podatkov, uporabnika FTP ali zapisa DNS ter ustavitev VPS se izvedejo takoj, brez dodatne potrditve. Pomočnik AI mora pred klicem potrditev pridobiti od uporabnika.
Gesla
Gesla ustvari sistem in jih vrne samo v odgovoru na ustvarjanje ali spremembo. Nikjer drugje se ne zapisujejo.
Naročila
Naročilo vedno ustvari predračun. Storitev se aktivira po plačilu, plača pa človek.
Dnevnik dejanj
Vsaka sprememba storitve se zabeleži in je vidna v polju actions storitve (GET /hosting/services/{obligation_id}) in v Terrakom One.
Različice
Znotraj v1 se samo dodaja (nova polja in naslovi). Kar bi pokvarilo obstoječe integracije, pride v v2, z najavo.
Odgovori in napake
Odgovor je JSON s polji success, message in data; podatki so v data (objekt ali seznam). Izjeme so PDF-ji, prenos datotek in /user/getBills. Če dejanje ni bilo izvedeno, je success enak false, razlog za stranko pa je v message. Koda HTTP je takrat največkrat vseeno 200, zato vedno preverite success.
{"success": false, "message": "Upišite ispravnu adresu i kvotu (50 MB – 50 GB).", "data": {}}| Koda | Pomen |
|---|---|
200 | Odgovor s polji success, message in data; preverite success. |
400 | Neveljaven naslov, pot ali dejanje, ki ni mogoče (s sporočilom). |
401 | Ključ ni bil poslan, ni veljaven, je potekel ali je preklican. |
403 | Vloga ključa tega ne dovoljuje. |
404 | Takega zapisa ni, storitev nima te možnosti ali ga ključ ne sme videti (s sporočilom). |
429 | Preveč zahtev za ta ključ. |