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://www.api.reseller.ba/v1/

Autentikacija #

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

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

Registruj domenu #

POST JSON polja

Primjer zahtjeva

copyPOST https://www.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": {
    "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

Tok

Nakon plaćanja transfer se pokreće kod registra i domena dobija status 2 (čeka transfer). Kad trenutni registrar potvrdi transfer, domena prelazi u status 3 (aktivna).

Produži domenu #

copyPOST https://www.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"
}

Odgovor

{
  "success": true,
  "data": {
    "proforma_invoice": { "proforma_number": "1043", "total": "45.00", "currency": "KM", "status": "nije_placen" },
    "domain": {
      "uuid": "9c1f4a2e-…", "domain": "primjer.ba", "period_years": 1,
      "post_expiry_period": "redovno", "renewal_price": "45.00",
      "grace_fee": "0.00", "redemption_fee": "0.00",
      "expires_at": "2026-10-02", "new_expires_at": "2027-10-02"
    },
    "auto_renewal": { "enabled": true, "message": "…" }
  }
}

post_expiry_period: redovno, grace ili redemption. U grace i redemption periodu naknada ide kao zasebna stavka predračuna. Obrisana (status 10), suspendovana i domena na čekanju se ne mogu obnoviti (409). Ako za domenu već postoji neplaćen predračun za obnovu, odgovor je 409 s njegovim brojem.

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",
  "registrant": { ... kontakt polja, bez imena i firme ... },
  "admin": { ... kontakt polja ... },
  "tech":  { ... kontakt polja ... }
}

Kontakt polja

name, email_address, address1, city, state_province, postal_code, country (ISO-2), phone (format +387.61123456). Za admin i tech su name i email_address obavezni; kod registranta se name ignoriše.

Promjena vlasnika (registranta) domene #

Dostupno samo za ekstenzije koje podržavaju promjenu vlasnika i imaju cijenu promjene za vaš nivo; za ostale odgovor je 409.

GET ?uuid=<uuid domene>

Vraća trenutnog registranta (sa registra), cijenu promjene (change_price) i polje billable_change: naziv_firme ili ime_prezime — koje se polje mora promijeniti. Ako već postoji zahtjev koji čeka plaćanje, vraća pending_request: true i podatke tog zahtjeva.

POST JSON polja

POST kreira zahtjev i predračun. Nakon plaćanja promjena se automatski primjenjuje kod registra. Neplaćen zahtjev otkazujete s {"uuid": "…", "akcija": "otkazi"}.

Naruči hosting #

POST JSON polja

Primjer zahtjeva

copyPOST https://www.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

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://www.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,
    "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://www.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": {
    "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://www.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": {
    "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

Promjena paketa hostinga #

Usluga s vlastitom IP adresom zadržava IP; novi paket mora nuditi IP za vaš nivo i ciklus. Ako server odbije novi paket (npr. zauzeto više prostora nego što novi paket dozvoljava), usluga ostaje na starom paketu.

Upravljanje hosting uslugom #

Suspendovana usluga se ne obnavlja automatski — tako WHMCS suspenzija zaustavlja obnovu (vidi Obnova usluga).

Produži licencu #

POST JSON polja

Primjer zahtjeva

copyPOST https://www.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.

Terminacija licence #

Obnova usluga, rokovi i istek #

Na nalogu postoje dvije odvojene postavke (reseller panel, Postavke; API: settings.php):

Ako kredita nema dovoljno, predračun ostaje neplaćen i čeka uplatu ili dopunu kredita — ništa se ne naplaćuje djelimično.

Automatska obnova UGAŠENA

Za domene, hosting, licence i dedicated servere predračun za obnovu izdaje se unaprijed, prije isteka (broj dana zavisi od ciklusa usluge) i šalje vam se mailom. Usluga se produžava čim je predračun plaćen. Obnovu možete pokrenuti i sami, u bilo kojem trenutku, pozivom renew endpointa.

Automatska obnova UPALJENA

Uslugu ili licencu uvijek možete produžiti i ručno, pozivom renew_hosting.php, renew_dedicated.php ili renew_license.php, odnosno iz WHMCS modula.

Novi period nakon obnove

Domena: stari datum isteka + broj godina. Hosting, licence i serveri: stari datum isteka + ciklus, bez prekida — obnova plaćena nekoliko dana nakon isteka ne pomjera datum. Ako je usluga stajala istekla duže od cijelog ciklusa, novi period počinje od dana plaćanja.

Šta se dešava s neobnovljenom uslugom

Moje domene #

Ponuda dedicated servera #

Odgovor

Odgovor ima dva dijela: packages (serveri) i options (dodatne opcije koje se biraju pri narudžbi).

{
  "success": true,
  "data": {
    "level": 2,
    "currency": { "code": "BAM", "suffix": "KM", "position": "after" },
    "decimal_separator": ",",
    "total_count": 11,
    "packages": [
      {
        "uuid": "3f1c8a20-68df-4cf7-9bd5-dc73b38acc8d",
        "name": "2 x 18 Core Xeon Gold 6254",
        "subtitle": "DELL PowerEdge R640",
        "featured": false,
        "sold_out": false,
        "specification": {
          "model": "DELL PowerEdge R640",
          "cpu": "Xeon Gold 6254",
          "cpu_count": 2,
          "cores": 36,
          "cpu_speed": "32 x 3.10 GHz",
          "hyperthreading": true,
          "ram_included": "64 GB",
          "ram_type": "DDR 4",
          "disks_included": [
            { "name": "960 GB SSD Enterprise", "count": 2 }
          ],
          "drive_bays": 8,
          "included_ip_addresses": 1
        },
        "available_options": {
          "ram":  ["ram-1", "ram-2", "ram-3"],
          "raid": ["raid-1", "raid-2"],
          "disk_slots": [
            ["disk-6", "disk-7"],
            ["disk-6", "disk-7"]
          ]
        },
        "prices": { "monthly": "799.20" }
      }
    ],
    "options": {
      "ram": [
        {
          "code": "ram-2",
          "name": "Nadogradnja na 128 GB",
          "free": false,
          "prices": { "monthly": "96.00" }
        }
      ],
      "disks": [ ... ],
      "internet": [ ... ],
      "management": [ ... ],
      "cpanel": [ ... ],
      "raid": [ ... ],
      "ip": [ ... ],
      "operating_systems": [ ... ]
    }
  }
}

Narudžba dedicated servera #

Zahtjev

{
  "package_uuid": "dddddddd-0000-4000-8000-000000000002",
  "cycle": "monthly",
  "hostname": "srv1.primjer.ba",
  "options": ["ram-2", "raid-2", "cp-1", "os-1"],
  "disks": ["disk-7", "disk-6"],
  "extra_ip": 4
}

Odgovor

{
  "success": true,
  "data": {
    "order": {
      "uuid": "7c2f9a10-4e88-4a31-b0d2-1f5e77c3a904",
      "order_number": "RSL-4839947402",
      "status": 1
    },
    "server": {
      "uuid": "b41d7e60-9c2a-4f18-8ad5-3e90b21c7f56",
      "name": "2 x 18 Core Xeon Gold 6254",
      "model": "DELL PowerEdge R640",
      "hostname": "srv1.primjer.ba",
      "cycle": "monthly",
      "cycle_months": 1,
      "level": 2,
      "price": "1044.06",
      "package_price": "849.15",
      "options_price": "194.91",
      "selected_options": ["Nadogradnja na 128 GB", "RAID 10"],
      "ordered_ip_addresses": 4,
      "status": 1
    },
    "proforma_invoice": {
      "number": "1587",
      "subtotal": "892.36",
      "vat_amount": "151.70",
      "total": "1044.06",
      "currency": "KM",
      "status": "unpaid"
    },
    "currency": { "prefix": "", "suffix": "KM", "position": "after" },
    "decimal_separator": ","
  }
}

Moji dedicated serveri #

Produži dedicated server #

Obnova je moguća za aktivan server i za server istekao unutar roka hosting_grace. Suspendovan, terminiran ili otkazan server daje 409; isto i ako već postoji neplaćen predračun za obnovu. Odgovor ima isti oblik kao renew_hosting.php (umjesto package i domain vraća hostname).

Upravljanje dedicated serverom #

Na suspendovanom serveru dozvoljeni su samo unsuspend i terminate. Odgovor vraća service.status i stanje mreže (network: on / off).

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):