Driveoskatalog platforme

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.

PoljeTipObaveznoOpis
page / pageSizeinteger—Straničenje; najviše 100 po stranici
activeboolean—Samo aktivirana vozila (true) ili samo neaktivirana (false)
json200 — vozila (skraćeno)
{
  "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.

PoljeTipObaveznoOpis
page / pageSizeinteger—Straničenje; najviše 100 po stranici
activeboolean—Samo aktivni vozači
json200 — vozači (skraćeno)
{
  "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

  1. Vožnja ulazi u dodjelu sa statusom REQUESTED.
  2. Poslužitelj bira vozače po pravilima tvrtke (zona, klasa vozila, udaljenost, ocjena, smjena) i šalje ponudu.
  3. Vozačka aplikacija prikazuje ponudu; prihvat mijenja status u ACCEPTED, odbijanje ili istek šalje ponudu dalje.
  4. Kad vozač prihvati, driver u detalju vožnje prestaje biti null — to je trenutak u kojem integracija može javiti putniku registraciju vozila.
Svjetla temaTamna tema
Ista flota u konzoli tvrtke: status, dokumenti, ocjena i vozilo.