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.
Prijavite se na nalog kompanije i otvorite odeljak API ključevi na ovoj stranici.
Napravite ključ i dajte mu jasan naziv, na primer „Sajt“.
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č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"
}
]
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.
| Parametar | Obavezan | Šta zadaje |
|---|---|---|
from | Da | Prvi dan perioda |
to | Da | Poslednji dan perioda, ne dalje od 31 dana od from |
masterId | Ne | Samo rezervacije jednog majstora |
status | Ne | Samo 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}.
| Polje | Šta sadrži |
|---|---|
date, startTime, endTime | Datum i vreme posete po vremenskoj zoni salona |
status | Status rezervacije, vidi ispod |
master | Majstor: id i name. null ako majstor nije izabran |
services | Usluge: id, name i trajanje duration u minutima |
client | Klijent: name i phone |
comment | Komentar uz rezervaciju ili null |
createdAt, updatedAt | Kada je rezervacija napravljena i kada je poslednji put menjana |
| Status | Značenje |
|---|---|
ACTIVE | Zakazano |
MASTER_CONFIRMATION | Čeka potvrdu majstora |
USER_CONFIRMATION | Čeka da klijent potvrdi novo vreme |
CONFIRMED | Potvrđeno |
REJECTED | Majstor je odbio, ili je klijent rekao da rezervacija nije njegova |
CANCELED | Otkazano |
Da biste pronašli šta se promenilo od prethodnog izvoza, uporedite updatedAt rezervacije sa vremenom tog izvoza.
Po jednom ključu - 60 zahteva u minuti. Koliko je preostalo, pokazuju zaglavlja odgovora X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset.
| Kod | Kada |
|---|---|
400 | Pogrešni datumi, to pre from, period duži od 31 dana ili nepoznat status |
401 | Nema ključa, ključ je pogrešan ili opozvan |
403 | Kompanija nema aktivnu pretplatu |
404 | Takva rezervacija ne postoji u vašoj kompaniji |
429 | Previše zahteva |