Driveoskatalog platforme

Kako drugi program naručuje vožnje

Za ljude koji spajaju drugi program na platformu: čemu to služi, kako se dobije pristup i kako izgleda prvi upit.

API je način da drugi program razgovara s platformom bez čovjeka u sredini. Primjer: hotelski sustav zna da gost dolazi u 5 ujutro i sam naruči vožnju — bez telefona, bez upisivanja i bez čekanja da netko primi poziv.

StavkaVrijednost
Osnovna adresahttps://driveos.eu/api/v1
AutentifikacijaAPI ključ u X-API-Key ili Authorization: Bearer <ključ>
FormatJSON, UTF-8; Content-Type: application/json
Ograničenje120 zahtjeva u minuti po ključu
Straničenjepage i pageSize (najviše 100, zadano 25)
Verzijav1 u putanji; nova verzija dobiva novi broj, stara se ne mijenja
UgovorGET /api/v1/openapi.json (OpenAPI 3.1)

Prvi poziv

Počnite s whoami: vraća naziv ključa, tvrtku i opsege koje ključ ima. Ako whoami prođe, ključ je ispravan i mreža je otvorena.

curl -s https://driveos.eu/api/v1/whoami \
  -H "X-API-Key: $DEMO_TAXI_KEY"
json200 — odgovor
{
  "key": {
    "name": "Rezervacije hotela",
    "scopes": ["read", "rides", "book", "pricing"]
  },
  "company": {
    "slug": "taxi-a",
    "displayName": "DEMO-TAXI",
    "currencyCode": "EUR",
    "countryCode": "HR",
    "timeZone": "Europe/Zagreb"
  }
}

Katalog usluga

Prije naručivanja dohvatite vrste usluge: serviceTypeId iz tog odgovora je obavezan u svakoj narudžbi. Isti poziv vraća i vozila i vozače ako ključ ima te opsege.

bash
curl -s https://driveos.eu/api/v1/service-types -H "X-API-Key: $DEMO_TAXI_KEY"
curl -s "https://driveos.eu/api/v1/vehicles?active=true&pageSize=50" -H "X-API-Key: $DEMO_TAXI_KEY"
curl -s "https://driveos.eu/api/v1/drivers?pageSize=50" -H "X-API-Key: $DEMO_TAXI_KEY"
json200 — vrste usluge (skraćeno)
{
  "serviceTypes": [
    {
      "id": "8f1c2a6e-6d4b-4f2a-9d31-2a7c1b6e5f01",
      "code": "STANDARD",
      "name": "Standard",
      "paymentMethods": ["CASH", "CARD"],
      "seatCount": 4,
      "isActive": true
    },
    { "id": "…", "code": "COMFORT", "name": "Comfort", "seatCount": 4, "isActive": true },
    { "id": "…", "code": "START", "name": "Start", "seatCount": 4, "isActive": true }
  ]
}

Straničenje i filtriranje

Svaki popis vraća meta s brojem stranica, pa se petlja ne mora pogađati. Parametri su isti na svim popisima: page, pageSize (ili limit), a na vožnjama još status, from, to, updatedSince, serviceTypeId, driverId, q i externalId.

jsonmeta u svakom popisu
{
  "rides": [ /* … */ ],
  "meta": { "page": 1, "pageSize": 25, "total": 128, "pages": 6, "hasMore": true }
}
Sinkronizacija bez preskakanjaZa redovnu sinkronizaciju koristite updatedSince (ISO 8601): dohvatite sve promjene od zadnjeg uspješnog poziva, a ride.updated webhook vam javi kad se nešto promijeni između dva ciklusa.

Vremena i vremenske zone

Sva vremena u odgovorima su ISO 8601 u UTC-u (2026-11-17T08:12:00.000Z). Datumi u filterima (from, to kod statistike) su lokalni dani tvrtke u formatu YYYY-MM-DD i tumače se u vremenskoj zoni tvrtke (Europe/Zagreb za DEMO-TAXI).

Što dalje