Vozači i vozila
Tko vozi i kojim vozilom: dva popisa koja se mogu samo čitati, jer se flota uređuje u konzoli.
Dispečeru i programeru treba isti odgovor na isto pitanje: tko trenutno vozi i kojim vozilom. Popis se samo čita; flota se uređuje u konzoli, gdje postoje papiri i provjere.
Vozila
GET/api/v1/vehicles
Popis vozila tvrtke. Opseg vehicles.
| Polje | Tip | Obavezno | Opis |
|---|---|---|---|
page / pageSize | integer | — | Straničenje; najviše 100 po stranici |
active | boolean | — | Samo aktivirana vozila (true) ili samo neaktivirana (false) |
{
"vehicles": [
{
"id": "2b7d1a4c-0f6e-4f8f-9d2a-6b3c1a5e7f21",
"plate": "ZG-1234-AB",
"model": "Škoda Octavia",
"color": "bijela",
"seatCount": 4,
"vehicleClass": { "code": "STANDARD", "name": "Standard" },
"isActive": true
}
],
"meta": { "page": 1, "pageSize": 25, "total": 12, "pages": 1, "hasMore": false }
}
Vozači
GET/api/v1/drivers
Popis vozača tvrtke. Opseg drivers. Vraća kod, ime, status i je li vozač na dužnosti.
| Polje | Tip | Obavezno | Opis |
|---|---|---|---|
page / pageSize | integer | — | Straničenje; najviše 100 po stranici |
active | boolean | — | Samo aktivni vozači |
{
"drivers": [
{
"id": "8c4f2b61-7a3d-4e5c-8b1f-2d6a9e0c3b47",
"code": "D-014",
"fullName": "Ivo Ivić",
"phone": "+385 91 555 0114",
"rating": 4.9,
"isActive": true,
"onDuty": true
}
],
"meta": { "page": 1, "pageSize": 25, "total": 7, "pages": 1, "hasMore": false }
}
Samo ono što integraciji trebaOdgovor ne sadrži OIB, broj osobne, dokumente, podatke o platnoj kartici ni povijest ocjena. Ako vam neko polje treba, to je razgovor o proširenju ugovora — ne pretpostavka da postoji.
Kako vožnja dobiva vozača
- Vožnja ulazi u dodjelu sa statusom
REQUESTED. - Poslužitelj bira vozače po pravilima tvrtke (zona, klasa vozila, udaljenost, ocjena, smjena) i šalje ponudu.
- Vozačka aplikacija prikazuje ponudu; prihvat mijenja status u
ACCEPTED, odbijanje ili istek šalje ponudu dalje. - Kad vozač prihvati,
driveru detalju vožnje prestaje bitinull— to je trenutak u kojem integracija može javiti putniku registraciju vozila.

