Véhicules disponibles

Objectif : sur le site de l’agence, le visiteur choisit des dates et voit les voitures libres.

Étape 1 — Préparer les filtres (optionnel)

GET /vehicles/filters

Retourne les types de véhicules, la fourchette de prix, et les tris possibles. Utile pour remplir les listes déroulantes du formulaire.

curl -sS "https://app.opticar.tn/api/v1/vehicles/filters" \
  -H "Authorization: Bearer opticar_VOTRE_CLE"

Étape 2 — Chercher les véhicules libres

GET /vehicles/available?start_date=2026-10-20&end_date=2026-10-25

Paramètres :

• start_date / end_date — obligatoires (format YYYY-MM-DD)
• type — ex. SUV (optionnel)
• min_price / max_price — optionnels
• sort — price_asc, price_desc ou name_asc

curl -sS "https://app.opticar.tn/api/v1/vehicles/available?start_date=2026-10-20&end_date=2026-10-25&sort=price_asc" \
  -H "Authorization: Bearer opticar_VOTRE_CLE"

Réponse : { "data": [ … ] } — chaque véhicule a un id, un nom, un tarif/jour, des photos, etc.

Astuce : une réservation encore « en attente » (api_pending) ne bloque pas le véhicule. Seules les réservations confirmées le rendent indisponible.

Étape 3 — Lieux et options (si besoin)

GET /places     → lieux de prise / retour
GET /addons     → options (siège bébé, GPS…)

Utilisez les id renvoyés plus tard dans la réservation (pickup_address, drop_off_address).

Sur le site

1. Formulaire : date début + date fin
2. Votre serveur appelle /vehicles/available
3. Vous affichez les résultats (photo, prix, bouton Réserver)

Ensuite : Créer une réservation →