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.
| Stavka | Vrijednost |
|---|---|
| Osnovna adresa | https://driveos.eu/api/v1 |
| Autentifikacija | API ključ u X-API-Key ili Authorization: Bearer <ključ> |
| Format | JSON, UTF-8; Content-Type: application/json |
| Ograničenje | 120 zahtjeva u minuti po ključu |
| Straničenje | page i pageSize (najviše 100, zadano 25) |
| Verzija | v1 u putanji; nova verzija dobiva novi broj, stara se ne mijenja |
| Ugovor | GET /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"const response = await fetch('https://driveos.eu/api/v1/whoami', {
headers: { 'X-API-Key': process.env.DEMO_TAXI_KEY },
});
if (!response.ok) throw new Error('API: ' + response.status);
const who = await response.json();
// {
// key: { name: 'Rezervacije hotela', scopes: ['read', 'rides', 'book'] },
// company: { slug: 'taxi-a', displayName: 'DEMO-TAXI', currencyCode: 'EUR' }
// }$ch = curl_init('https://driveos.eu/api/v1/whoami');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('DEMO_TAXI_KEY')],
]);
$body = json_decode(curl_exec($ch), true, 512, JSON_THROW_ON_ERROR);
curl_close($ch);{
"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.
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"
{
"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.
{
"rides": [ /* … */ ],
"meta": { "page": 1, "pageSize": 25, "total": 128, "pages": 6, "hasMore": true }
}
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).