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.resellerunion.com/v1/

Autentikacija #

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

copyGET https://api.resellerunion.com/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.resellerunion.com/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…",
    "proforma_invoice": { "number": "SB-2026-04128", "total": "61.51" },
    "order":  { "order_number": "RSL-4820193756", "status": 1 },
    "license":   { "name": "cPanel Admin Cloud", "ip": "185.99.1.50", "status": 1 }
  }
}

Dostupni endpointi

Cjenovnik domena #

Primjer zahtjeva

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

Odgovor

{
  "success": true,
  "data": {
    "level": 2,
    "currency": "BAM",
    "decimal_separator": ".",
    "total_count": 42,
    "domains": [
      {
        "extension": ".ba",
        "featured": true,
        "registration_price": "29.90",
        "renewal_price": "29.90",
        "registration_periods": {
          "1": "29.90",
          "2": "55.00",
          "5": "125.00"
        },
        "custom_fields": [
          {
            "slot": 1,
            "required": true,
            "type": "check",
            "name": "Suglasnost s uvjetima registracije",
            "description": "Potvrdite kvačicom da ste pročitali i prihvatili Pravilnik o registraciji .ba domena.",
            "validation": "^(true)$"
          },
          {
            "slot": 2,
            "required": true,
            "type": "input",
            "name": "Svrha registracije domene",
            "description": "Ukratko opišite za šta će se domena koristiti (najmanje 5 znakova).",
            "validation": "^.{5,}$"
          }
        ]
      }
    ]
  }
}

Ponuda hostinga #

Primjer zahtjeva

copyGET https://api.resellerunion.com/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,
    "currency": "BAM",
    "total_count": 6,
    "packages": [
      {
        "uuid": "3f2a1b6c-9d4e-4f70-8a21-5e6d7c8b9a01",
        "name": "Business",
        "disk_space": "10 GB",
        "bandwidth": "Neograničen",
        "requires_domain": true,
        "prices": {
          "monthly": "9.90",
          "annually": "99.00"
        }
      }
    ]
  }
}

Provjeri dostupnost domene #

GET parametri

Primjer zahtjeva

copyGET https://api.resellerunion.com/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.resellerunion.com/v1/whois.php?format=text&domain=",
  "available":  "STATUS: AVAILABLE"
}

Registruj domenu #

POST JSON polja

Primjer zahtjeva

copyPOST https://api.resellerunion.com/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": {
    "is_company": 0,
    "first_name": "Amir",
    "last_name": "Amirović",
    "address": "Ulica bb",
    "city": "Sarajevo",
    "postal_code": "71000",
    "country": "BA",
    "email": "amir@primjer.ba",
    "phone": "+38761111222"
  },
  "nameservers": ["ns1.primjer.ba", "ns2.primjer.ba"],
  "custom_fields": {
    "1": "true",
    "2": "Prezentacija firme i kontakt stranica"
  }
}

Odgovor

Odgovor je ugniježđen: data sadrži četiri objekta — order, domain, proforma_invoice i currency. UUID narudžbe je data.order.uuid, a UUID domene data.domain.uuid — ne data.uuid.

{
  "success": true,
  "data": {
    "order": {
      "uuid": "945bda1a-2a36-4f7e-acfd-4c3cfd158a99",
      "order_number": "RSL-3430439926",
      "status": 1
    },
    "domain": {
      "uuid": "4dd69549-68df-4cf7-9bd5-dc73b38acc8d",
      "domain": "primjer.ba",
      "extension": ".ba",
      "registration_period": 1,
      "level": 2,
      "price": "58.67",
      "status": 1,
      "nameservers": ["ns1.primjer.ba", "ns2.primjer.ba"],
      "custom_fields": {
        "1": "true",
        "2": "Prezentacija firme"
      }
    },
    "proforma_invoice": {
      "proforma_number": "1564",
      "subtotal": "50.15",
      "vat_amount": "8.52",
      "total": "58.67",
      "currency": "KM",
      "status": "nije_placen"
    },
    "currency": {
      "code": "BAM",
      "prefix": "",
      "suffix": "KM",
      "position": "after",
      "space": 1,
      "rate": "1.000000"
    },
    "decimal_separator": ","
  }
}

Transfer domene #

POST JSON polja

Produži domenu #

copyPOST https://api.resellerunion.com/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.resellerunion.com/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

Odgovor je ugniježđen: data sadrži order, service, proforma_invoice, auto_activation i currency. UUID usluge je data.service.uuid.

{
  "success": true,
  "data": {
    "order": {
      "uuid": "e7a0565d-a746-456e-8938-68412977e573",
      "order_number": "RSL-3036365111",
      "status": 1
    },
    "service": {
      "uuid": "c3c3b3f0-db2f-42cc-a195-99e6a97aedb8",
      "package": "START HOSTING",
      "cycle": "annually",
      "cycle_months": 12,
      "domain": "primjer.ba",
      "level": 1,
      "price": "54.40",
      "status": 1,
      "dedicated_ip": false,
      "package_price": "54.40",
      "dedicated_ip_price": null
    },
    "proforma_invoice": {
      "proforma_number": "1564",
      "subtotal": "46.50",
      "vat_amount": "7.90",
      "total": "54.40",
      "currency": "KM",
      "status": "nije_placen"
    },
    "auto_activation": {
      "enabled": true,
      "message": "Automatska aktivacija: dostupan kredit pokriva iznos predračuna."
    },
    "currency": {
      "prefix": "",
      "suffix": "KM",
      "position": "after",
      "space": 1
    },
    "decimal_separator": ","
  }
}

Moje hosting usluge #

Ponuda licenci #

Primjer zahtjeva

copyGET https://api.resellerunion.com/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,
    "currency": { "code": "BAM", "suffix": "KM", "position": "after", "space": 1 },
    "decimal_separator": ",",
    "categories": [ { "name": "cPanel/WHM" }, { "name": "CloudLinux" } ],
    "total_count": 24,
    "licenses": [
      {
        "uuid":         "3f2a1b6c-9d4e-4f70-8a21-5e6d7c8b9a01",
        "name":        "cPanel Admin Cloud",
        "category":   "cPanel/WHM",
        "host_type":    "virtual",
        "max_accounts": 5,
        "term_months": 1,
        "featured":    true,
        "prices":       { "monthly": "61.51" }
      }
    ]
  }
}

Naruči licencu #

POST JSON polja

Primjer zahtjeva

copyPOST https://api.resellerunion.com/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": {
    "proforma_invoice": { "number": "P-2026-00412", "total": "61.51", "currency": "KM", "status": "nije_placen" },
    "order":  { "uuid": "…", "order_number": "RSL-0000100042", "status": 1 },
    "license":   { "uuid": "…", "name": "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.resellerunion.com/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": {
    "proforma_invoice": { "proforma_number": "P-2026-00518", "total": "19.56", "currency": "KM", "status": "nije_placen" },
    "service": {
      "uuid": "7c1e9a2b-…", "package": "BUSINESS HOSTING", "domain": "primjer.ba",
      "cycle_months": 1, "expires_at": "2026-08-20", "new_period_until": "2026-09-19"
    },
    "auto_activation": { "enabled": true, "message": "Automatska obnova: dostupan kredit…" }
  }
}

Kada je obnova moguća

Produži licencu #

POST JSON polja

Primjer zahtjeva

copyPOST https://api.resellerunion.com/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 ova platforma. 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):