Reseller.ba
Reseller API

Pregled #

Svi endpointi su REST pozivi sa JSON odgovorima. Uspješan odgovor uvijek ima "success": true i podatke u "data" objektu; greška ima "success": false i "error" poruku.

https://api.reseller.ba/v1/

Autentikacija #

Svaki zahtjev se autentificira s dva headera koja idu zajedno kao par:

copyGET https://api.reseller.ba/v1/price_list.php
X-API-UUID:   550e8400-e29b-41d4-a716-446655440000
X-API-KEY:    your_api_key

Greške i limiti #

// Primjer greške
{
  "success": false,
  "error":   "Field \"package_uuid\" is required."
}

Sandbox #

Testno okruženje za razvoj integracije. Iste putanje i isti format odgovora kao produkcija, ali bez ikakvih stvarnih podataka i bez posljedica.

Kredencijali

Javni su i isti za sve — ne treba vam nalog:

copyX-API-UUID: 00000000-0000-4000-8000-000000000001
X-API-KEY:  sandbox_kljuc_za_testiranje_1234567

Kako se ponaša

Primjer

copyPOST https://sandbox.reseller.ba/v1/order_license.php
Content-Type: application/json; charset=utf-8
X-API-UUID:   00000000-0000-4000-8000-000000000001
X-API-KEY:    sandbox_kljuc_za_testiranje_1234567

{
  "package_uuid": "aaaaaaaa-0000-4000-8000-000000000001",
  "cycle": "monthly",
  "ip": "185.99.1.50"
}

// Odgovor
{
  "success": true,
  "sandbox": true,
  "sandbox_napomena": "Testno okruženje (sandbox). Podaci su fiktivni…",
  "data": {
    "sandbox_upozorenje": "SANDBOX: narudžba je simulirana i NIJE izvršena…",
    "predracun": { "broj": "SB-2026-04128", "total": "61.51" },
    "narudzba":  { "broj_narudzbe": "RSL-4820193756", "status": 1 },
    "licenca":   { "naziv": "cPanel Admin Cloud", "ip": "185.99.1.50", "status": 1 }
  }
}

Dostupni endpointi

Cjenovnik domena #

Primjer zahtjeva

copyGET https://api.reseller.ba/v1/price_list.php
X-API-UUID:   550e8400-e29b-41d4-a716-446655440000
X-API-KEY:    your_api_key

Odgovor

{
  "success": true,
  "data": {
    "level": 2,
    "valuta": "BAM",
    "decimalni_separator": ".",
    "ukupno": 42,
    "domene": [
      {
        "ekstenzija": ".ba",
        "istaknuto": true,
        "cijena_registracije": "29.90",
        "cijena_produzenja": "29.90",
        "registracijski_periodi": {
          "1": "29.90",
          "2": "55.00",
          "5": "125.00"
        }
      }
    ]
  }
}

Ponuda hostinga #

Primjer zahtjeva

copyGET https://api.reseller.ba/v1/hosting_offer.php
X-API-UUID:   550e8400-e29b-41d4-a716-446655440000
X-API-KEY:    your_api_key

Odgovor (skraćeno)

{
  "success": true,
  "data": {
    "level": 2,
    "valuta": "BAM",
    "ukupno": 6,
    "paketi": [
      {
        "uuid": "3f2a1b6c-9d4e-4f70-8a21-5e6d7c8b9a01",
        "naziv": "Business",
        "prostor": "10 GB",
        "promet": "Neograničen",
        "zahtjeva_domenu": true,
        "cijene": {
          "mjesecna": "9.90",
          "godisnja": "99.00"
        }
      }
    ]
  }
}

Provjeri dostupnost domene #

GET parametri

Primjer zahtjeva

copyGET https://api.reseller.ba/v1/whois.php?domain=mojafirma.com

Odgovor

{
  "success": true,
  "data": {
    "domain":    "mojafirma.com",
    "extension": ".com",
    "available": true
  }
}

Tekstualni format (WHMCS whois.json)

Sa parametrom format=text endpoint vraća čisti tekst — namijenjen za WHMCS whois.json "https://" lookup. Odgovor je uvijek HTTP 200 (WHMCS poredi tijelo, ne HTTP kod):

STATUS: AVAILABLE
STATUS: REGISTERED
STATUS: ERROR: <poruka>

Primjer whois.json unosa za .ba ekstenzije (nemaju javni port-43 whois server):

copy{
  "extensions": ".ba,.edu.ba",
  "uri":        "https://api.reseller.ba/v1/whois.php?format=text&domain=",
  "available":  "STATUS: AVAILABLE"
}

Registruj domenu #

POST JSON polja

Primjer zahtjeva

copyPOST https://api.reseller.ba/v1/order_domain.php
Content-Type: application/json; charset=utf-8
X-API-UUID:   550e8400-e29b-41d4-a716-446655440000
X-API-KEY:    your_api_key

{
  "domain": "primjer.org.ba",
  "period": 1,
  "registrant": {
    "pravno_lice": 0,
    "ime": "Amir",
    "prezime": "Amirović",
    "adresa": "Ulica bb",
    "grad": "Sarajevo",
    "postanski_broj": "71000",
    "drzava": "BA",
    "email": "amir@primjer.ba",
    "telefon": "+38761111222"
  }
}

Odgovor

Uspješna narudžba vraća podatke narudžbe i domene: uuid, broj_narudzbe, level, cijena, valuta, status. Kreirani predračun stiže korisniku emailom, a domenu dalje pratite kroz my_domains.php preko dobijenog uuid-a.

Transfer domene #

POST JSON polja

Produži domenu #

copyPOST https://api.reseller.ba/v1/renew_domain.php
Content-Type: application/json; charset=utf-8
X-API-UUID:   550e8400-e29b-41d4-a716-446655440000
X-API-KEY:    your_api_key

{
  "uuid": "9c1f4a2e-7b3d-4e58-a690-1f2e3d4c5b6a"
}

EPP kod #

copy{
  "uuid": "9c1f4a2e-7b3d-4e58-a690-1f2e3d4c5b6a"
}

Nameserveri domene #

POST JSON polja

copy{
  "uuid": "9c1f4a2e-7b3d-4e58-a690-1f2e3d4c5b6a",
  "nameservers": ["ns1.primjer.ba", "ns2.primjer.ba"]
}

Kontakti domene #

copy{
  "uuid": "9c1f4a2e-7b3d-4e58-a690-1f2e3d4c5b6a",
  "admin": { ... kontakt polja ... },
  "tech":  { ... kontakt polja ... }
}

Promjena registranta #

POST JSON polja

Naruči hosting #

POST JSON polja

Primjer zahtjeva

copyPOST https://api.reseller.ba/v1/order_hosting.php
Content-Type: application/json; charset=utf-8
X-API-UUID:   550e8400-e29b-41d4-a716-446655440000
X-API-KEY:    your_api_key

{
  "package_uuid": "3f2a1b6c-9d4e-4f70-8a21-5e6d7c8b9a01",
  "cycle": "godisnja",
  "domain": "primjer.ba"
}

Odgovor

Uspješna narudžba vraća podatke narudžbe, usluge i predračuna: uuid, broj_narudzbe, paket, ciklus, level, cijena, valuta, status. Uslugu dalje pratite kroz my_hosting.php.

Moje hosting usluge #

Ponuda licenci #

Primjer zahtjeva

copyGET https://api.reseller.ba/v1/license_offer.php
X-API-UUID: 550e8400-e29b-41d4-a716-446655440000
X-API-KEY:  your_api_key

Odgovor (skraćeno)

{
  "success": true,
  "data": {
    "level": 2,
    "valuta": { "kod": "BAM", "sufix": "KM", "pozicija": "after", "razmak": 1 },
    "decimalni_separator": ",",
    "kategorije": [ { "naziv": "cPanel/WHM" }, { "naziv": "CloudLinux" } ],
    "ukupno": 24,
    "licence": [
      {
        "uuid":         "3f2a1b6c-9d4e-4f70-8a21-5e6d7c8b9a01",
        "naziv":        "cPanel Admin Cloud",
        "kategorija":   "cPanel/WHM",
        "host_type":    "virtual",
        "max_accounts": 5,
        "term_mjeseci": 1,
        "istaknuto":    true,
        "cijene":       { "mjesecna": "61.51" }
      }
    ]
  }
}

Naruči licencu #

POST JSON polja

Primjer zahtjeva

copyPOST https://api.reseller.ba/v1/order_license.php
Content-Type: application/json; charset=utf-8
X-API-UUID:   550e8400-e29b-41d4-a716-446655440000
X-API-KEY:    your_api_key

{
  "package_uuid": "3f2a1b6c-9d4e-4f70-8a21-5e6d7c8b9a01",
  "cycle": "monthly",
  "ip": "185.99.1.50"
}

Odgovor

{
  "success": true,
  "data": {
    "predracun": { "broj": "P-2026-00412", "total": "61.51", "valuta": "KM", "status": "nije_placen" },
    "narudzba":  { "uuid": "…", "broj_narudzbe": "RSL-0000100042", "status": 1 },
    "licenca":   { "uuid": "…", "naziv": "cPanel Admin Cloud", "ip": "185.99.1.50", "status": 1 }
  }
}

Licenca ostaje u statusu Na čekanju dok se predračun ne plati. Nakon uplate se aktivira i dobiva licenseid — stanje pratite kroz my_licenses.php.

Moje licence #

Produži hosting uslugu #

POST JSON polja

Cijena se ne šalje — određuje je sistem prema vašem cjenovnom nivou i ciklusu koji usluga ima.

Primjer zahtjeva

copyPOST https://api.reseller.ba/v1/renew_hosting.php
Content-Type: application/json; charset=utf-8
X-API-UUID:   550e8400-e29b-41d4-a716-446655440000
X-API-KEY:    your_api_key

{
  "uuid": "7c1e9a2b-4d38-4f61-9b02-1a5c8e7d3f40"
}

Odgovor

{
  "success": true,
  "data": {
    "predracun": { "broj_predracuna": "P-2026-00518", "total": "19.56", "valuta": "KM", "status": "nije_placen" },
    "usluga": {
      "uuid": "7c1e9a2b-…", "paket": "BUSINESS HOSTING", "domena": "primjer.ba",
      "ciklus_mjeseci": 1, "datum_isteka": "2026-08-20", "novi_period_do": "2026-09-19"
    },
    "auto_aktivacija": { "ukljucena": true, "poruka": "Automatska obnova: dostupan kredit…" }
  }
}

Kada je obnova moguća

Produži licencu #

POST JSON polja

Primjer zahtjeva

copyPOST https://api.reseller.ba/v1/renew_license.php
Content-Type: application/json; charset=utf-8
X-API-UUID:   550e8400-e29b-41d4-a716-446655440000
X-API-KEY:    your_api_key

{
  "uuid": "9a4f2c81-6b30-4e75-8d19-3f7b2e5a1c68"
}

Odgovor je istog oblika kao kod hostinga, s blokom licenca umjesto usluga. Ista pravila vrijede i za stanja u kojima obnova nije moguća, kao i za postojeći neplaćeni predračun.

Automatska obnova i aktivacija #

Na vašem nalogu možete uključiti automatsku aktivaciju i obnovu. Postavka se nalazi u reseller panelu, pod Postavke.

Kako radi

Svaka narudžba i svaka obnova kreiraju predračun. Razlika je samo u tome ko ga plaća:

Domene

Obnova domene se pokreće vašim pozivom — kroz API ili WHMCS modul. Čim poziv stigne, kreira se predračun i, ako je automatska obnova uključena i ima dovoljno kredita, odmah se naplaćuje i domena se produžava kod registra.

Rok do kojeg se istekla domena još može obnoviti određuje registar te ekstenzije, ne reseller.ba. Grace period po ekstenziji vidite u cjenovniku domena.

Hosting usluge i licence

Ako je automatska obnova uključena, hosting usluga ili licenca se produžava određeni broj dana nakon isteka, pod uslovom da joj u međuvremenu niste promijenili stanje u suspendirano ili otkazano. Zadana vrijednost je dva dana; tačan rok za vaš nalog vidite u reseller panelu pod Postavke, a vraća ga i my_profile.php u poljima hosting_grace i licence_grace.

Taj rok je namjerno ostavljen kao vaš prostor: WHMCS ne javlja da uslugu treba produžiti, ali javlja kada je treba suspendovati ili terminirati. Ako vaš klijent ne plati i vi uslugu suspendujete ili otkažete, obnova se ne izvršava i kredit vam se ne skida. Ako ništa ne poduzmete, sistem to razumije kao potvrdu da usluga treba raditi dalje i produžava je.

Moje domene #

Moji dokumenti #

Moj profil #

Kredit #

Postavke #

Registrant podaci #

Objekat registrant koji se šalje pri registraciji i transferu domene:

Ciklusi naplate #

Polje cycle pri narudžbi hostinga prima jednu od sljedećih vrijednosti (string):