Ordino API

Uvod i osnove

Osnovna adresa API-ja dodjeljuje se pri aktivaciji API pristupa (Premium paket).

BAZA = https://app.ordino.ba/api

• Svi zahtjevi i odgovori su JSON — šaljite header Content-Type: application/json i Accept: application/json.
• Zaštićene rute traže header Authorization: Bearer <token>.
• Svi podaci su izolovani po ustanovi — token vidi samo podatke svoje ustanove.
• Datumi su YYYY-MM-DD, vremena HH:MM (24h).

Autentikacija

Prijava slugom ustanove i PIN-om korisnika. Vraća Sanctum bearer token koji šaljete u svakom sljedećem zahtjevu.

# zahtjev
curl -X POST {BAZA}/login \
  -H "Content-Type: application/json" \
  -d '{"slug": "vasa-klinika", "pin": "1234"}'

# odgovor 200
{
  "token": "1|xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "user":    { "id": 1, "ime": "Sestra Milica", "role": "nurse" },
  "partner": { "id": 1, "slug": "vasa-klinika", "name": "Vaša Klinika" }
}

Podaci o prijavljenom korisniku i ustanovi.

Poništava trenutni token. Odgovor: {"ok": true}

Doktori

Baza doktora ustanove.

# primjer: novi doktor
curl -X POST {BAZA}/doctors \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "dr", "name": "Milica Jovanović", "specialty": "Pedijatar", "published_on_web": true}'

# odgovor 201
{ "id": 7, "title": "dr", "name": "Milica Jovanović", "specialty": "Pedijatar",
  "photo_path": null, "published_on_web": true, "sort_order": 0 }

Raspored

Termini rada doktora — ono što se prikazuje na webu, TV-u i u objavama.

# primjer: doktor radi u srijedu
curl -X POST {BAZA}/schedule \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"doctor_id": 7, "date": "2026-07-15", "time_from": "09:00", "time_to": "15:00"}'

Termini (zakazivanja)

Zakazani pregledi pacijenata.

Termin nosi doktora, pacijenta, datum i vrijeme te status (npr. potvrđen / otkazan). Duplikat termina za isti slot API odbija sa 422.

Pacijenti

Evidencija pacijenata ustanove (osoblje).

Web feed — raspored za vaš sajt

Javni, read-only feed rasporeda za prikaz na web stranici ustanove (koristi ga i naš WordPress dodatak). Autorizacija ključem ustanove.

# zahtjev
curl "{BAZA}/feed?key=VAS-WEB-KLJUC"

# odgovor 200 — doktori + raspored narednih 14 dana
{
  "doctors": [
    { "id": 7, "title": "dr", "name": "Milica Jovanović", "specialty": "Pedijatar", "photo_path": null }
  ],
  "schedule": [
    { "doctor_id": 7, "doctor": "dr Milica Jovanović", "specialty": "Pedijatar",
      "date": "2026-07-15", "time_from": "09:00", "time_to": "15:00", "location": null }
  ]
}

Vraćaju se samo doktori označeni sa published_on_web: true.

Javni podaci ustanove

Javne rute za prikaz doktora i slobodnih termina (npr. za vlastitu formu zakazivanja). Bez tokena — po slugu ustanove.

# slobodni termini doktora za dan
curl "{BAZA}/public/vasa-klinika/slots?doctor_id=7&date=2026-07-15"

# odgovor
{ "slots": ["09:00", "09:30", "10:00", "11:30"] }

TV ekrani

Uparivanje i podaci za TV prikaz u čekaonici. Ove rute koristi Ordino TV aplikacija — dokumentovane su radi potpunosti.

Greške i limiti

Standardni HTTP statusi + Laravel JSON format grešaka.

# primjer 422
{ "message": "The name field is required.",
  "errors": { "name": ["The name field is required."] } }

Rate limiti (po minuti)