← Home

Fleet API koppeling

Met deze API koppel je gangbare voertuigbeheersystemen direct aan een agency in Caribogo. De endpoint ondersteunt upsert: bestaande voertuigen worden bijgewerkt, nieuwe voertuigen worden aangemaakt.

Endpoint

POST /api/v1/agencies/{agency_slug}/fleet/sync

Authenticatie

Voeg de API-key toe in request-header:

X-Caribogo-Api-Key: jouw-geheime-key

Beheer de agency-key in admin via Agentschappen → Bewerken. Zonder agency-key gebruikt de endpoint de globale fallback CARIBOGO_FLEET_SYNC_API_KEY.

Verwachte JSON payload

{
  "vehicles": [
    {
      "external_id": "rental-system-veh-10027",
      "type": "car",
      "brand": "Kia",
      "model": "Picanto",
      "registration_plate": "B-20342",
      "price_per_day": 49.95,
      "price_per_week": 289.00,
      "price_per_month": 899.00,
      "fleet_status": "active",
      "available_for_booking": true,
      "visible_on_map": true,
      "seats": 5,
      "transmission": "automatic",
      "fuel_type": "gasoline",
      "color": "white",
      "description": "Compacte eilandauto met airco.",
      "map_latitude": 12.1584,
      "map_longitude": -68.2739
    }
  ]
}

Type- en statuswaarden

type: car, boat, scooter, electric_step, electric_bike, motorcycle, golf_cart, buggy
fleet_status: active, maintenance, broken, reserved, rented

Gedrag van de sync

Matching gebeurt op fleet_unit_uid (op basis van external_id) en op registration_plate.
Als een voertuig al aan een andere agency is gekoppeld, wordt die regel als conflict teruggegeven.
Response bevat altijd een samenvatting met requested, created, updated en conflicts.

Voorbeeld met cURL

curl -X POST "https://jouwdomein.com/api/v1/agencies/sunrent/fleet/sync" \
  -H "Content-Type: application/json" \
  -H "X-Caribogo-Api-Key: jouw-geheime-key" \
  -d @fleet-payload.json

Tip: plan de sync periodiek (bijv. elke 5-15 minuten) vanuit je voertuigbeheersysteem voor bijna realtime beschikbaarheid.