UzmiTermin API šalje rezervacije vaše kompanije na vaš server u JSON formatu: datum i vreme, status, majstora, usluge, ime i telefon klijenta. Tako možete prikazati predstojeće posete u korisničkom nalogu na sajtu, izvesti rezervacije u tabelu ili ih proslediti u CRM. API služi samo za čitanje. U ovom vodiču napravićete ključ, poslati prvi zahtev i razložiti odgovor.

Pre nego što počnete

Napravite ključ

  1. Prijavite se na nalog kompanije i otvorite odeljak API ključevi na ovoj stranici.

  2. Napravite ključ i dajte mu jasan naziv, na primer „Sajt“.

  3. Odmah kopirajte ključ i sačuvajte ga u podešavanjima servera - na primer, u promenljivoj okruženja UZMI_API_KEY. Ključ se prikazuje samo jednom: čuvamo samo njegov otisak, pa se izgubljeni ključ ne može vratiti, već samo zameniti novim.

Ako je ključ možda dospeo u tuđe ruke, opozovite ga: prestaće da radi odmah.

Nabavite API ključ

Pošaljite prvi zahtev

Prosledite ključ u zaglavlju Authorization i zatražite rezervacije za nedelju dana:

curl "https://public-api.uzmitermin.rs/v1/appointments?from=2026-10-19&to=2026-10-25" \
  -H "Authorization: Bearer $UZMI_API_KEY"

U odgovoru stiže niz rezervacija, sortiran po datumu i vremenu početka:

[
  {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "date": "2026-10-23",
    "startTime": "10:00",
    "endTime": "11:00",
    "status": "CONFIRMED",
    "master": { "id": "1b4e28ba-2fa1-41d2-883f-0016d3cca427", "name": "Irina" },
    "services": [{ "id": "6fa459ea-ee8a-4ca4-894e-db77e160355e", "name": "Šišanje", "duration": 60 }],
    "client": { "name": "Ana", "phone": "+381601234567" },
    "comment": null,
    "createdAt": "2026-10-20T12:00:00.000Z",
    "updatedAt": "2026-10-21T09:30:00.000Z"
  }
]

Preuzmite rezervacije za period

Period se zadaje parametrima from i to - datumi u formatu YYYY-MM-DD, oba uključena, period ne duži od 31 dana. Rezervacije stižu sve odjednom, bez straničenja.

ParametarObavezanŠta zadaje
fromDaPrvi dan perioda
toDaPoslednji dan perioda, ne dalje od 31 dana od from
masterIdNeSamo rezervacije jednog majstora
statusNeSamo rezervacije sa ovim statusima, odvojenim zarezom: CONFIRMED,MASTER_CONFIRMATION

Isti zahtev iz koda sajta:

PHP

<?php
$url = 'https://public-api.uzmitermin.rs/v1/appointments?' . http_build_query([
    'from' => '2026-10-19',
    'to' => '2026-10-25',
    'status' => 'CONFIRMED',
]);

$response = file_get_contents($url, false, stream_context_create([
    'http' => ['header' => 'Authorization: Bearer ' . getenv('UZMI_API_KEY')],
]));

$appointments = json_decode($response, true);

Node.js

const params = new URLSearchParams({ from: '2026-10-19', to: '2026-10-25', status: 'CONFIRMED' });

const response = await fetch(`https://public-api.uzmitermin.rs/v1/appointments?${params}`, {
    headers: { Authorization: `Bearer ${process.env.UZMI_API_KEY}` },
});

const appointments = await response.json();

Jednu rezervaciju možete preuzeti po identifikatoru: GET /v1/appointments/{id}.

Razložite odgovor

PoljeŠta sadrži
date, startTime, endTimeDatum i vreme posete po vremenskoj zoni salona
statusStatus rezervacije, vidi ispod
masterMajstor: id i name. null ako majstor nije izabran
servicesUsluge: id, name i trajanje duration u minutima
clientKlijent: name i phone
commentKomentar uz rezervaciju ili null
createdAt, updatedAtKada je rezervacija napravljena i kada je poslednji put menjana
StatusZnačenje
ACTIVEZakazano
MASTER_CONFIRMATIONČeka potvrdu majstora
USER_CONFIRMATIONČeka da klijent potvrdi novo vreme
CONFIRMEDPotvrđeno
REJECTEDMajstor je odbio, ili je klijent rekao da rezervacija nije njegova
CANCELEDOtkazano

Da biste pronašli šta se promenilo od prethodnog izvoza, uporedite updatedAt rezervacije sa vremenom tog izvoza.

Obradite greške i ograničenja

Po jednom ključu - 60 zahteva u minuti. Koliko je preostalo, pokazuju zaglavlja odgovora X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset.

KodKada
400Pogrešni datumi, to pre from, period duži od 31 dana ili nepoznat status
401Nema ključa, ključ je pogrešan ili opozvan
403Kompanija nema aktivnu pretplatu
404Takva rezervacija ne postoji u vašoj kompaniji
429Previše zahteva

Šta dalje