Premiers pas avec l’API

L’API Opticar permet au site web d’une agence d’afficher les véhicules disponibles et d’envoyer des demandes de réservation dans Opticar.

En 4 étapes

1. Obtenir une clé API (ci-dessous)
2. Chercher les véhicules disponibles
3. Créer le client et la réservation
4. Recevoir les confirmations (optionnel mais recommandé)

URL de base

https://app.opticar.tn/api/v1

Toujours en HTTPS. Réponses en JSON.

Votre clé API

Chaque agence a sa propre clé (format opticar_…). Elle est créée dans l’admin Opticar (fiche agence → clés API) et n’est affichée qu’une fois.

Ajoutez-la à chaque requête :

Authorization: Bearer opticar_VOTRE_CLE

ou :

X-API-Key: opticar_VOTRE_CLE

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

Important

• Appelez l’API depuis votre serveur (PHP, Node, etc.), jamais depuis le JavaScript du navigateur
• Limite : 60 requêtes / minute
• Sans clé valide → 401

Comment ça se passe

1. Le client choisit des dates sur le site de l’agence
2. Votre serveur demande les véhicules libres à Opticar
3. Le client réserve → Opticar reçoit une demande « en attente » (api_pending)
4. L’agence accepte ou refuse dans Opticar
5. (Optionnel) Opticar prévient votre site par webhook

Ce que l’API ne fait pas

• Pas de widget prêt à coller (iframe) — vous construisez les pages du site
• Pas de liste de véhicules sans dates de location
• Pas de paiement en ligne via cette API

Ensuite : Afficher les véhicules disponibles →