lexio-rent : client Python de l'API Lexio Rent

Client Python de l'API publique de Lexio Rent. Il couvre les 93 opérations de la version 1 : flotte, catalogue, tarification, devis, locations, départ et retour, paiements, entretien et flux d'événements.

Lexio Rent est un logiciel de gestion de location de voitures, utilitaires et deux-roues pour les loueurs professionnels. Il gère le planning, les contrats, les états des lieux, les cautions et la flotte. L'API sert à brancher Lexio Rent sur votre site de réservation, votre comptabilité, un entrepôt de données ou un agent IA.

Installation

pip install lexio-rent

Python 3.9 ou plus récent. Seule dépendance : httpx.

Clé API

Dans Lexio : Paramètres → Développeur → Tokens API → Nouveau token. La clé commence par lck_. L'API est disponible avec le plan Business et n'a pas de bac à sable : testez sur une organisation dédiée.

export LEXIO_API_KEY="lck_..."

Démarrage

from lexio_rent import Lexio

lexio = Lexio()  # lit LEXIO_API_KEY ; ou Lexio(api_key="lck_...")

# Organisation liée à la clé
print(lexio.organization.get()["data"]["name"])

# Toute la flotte active, page après page
for vehicle in lexio.paginate(lexio.vehicles.list, is_archived=False):
    print(vehicle["registrationNumber"], vehicle["status"])

# Un devis, puis une location au prix du devis
quote = lexio.quotes.create({
    "vehicleId": vehicle["id"],
    "startAt": "2026-12-14T09:00:00",   # heure locale du loueur, sans décalage
    "endAt": "2026-12-16T18:00:00",
})["data"]

rental = lexio.rentals.create({
    "quoteId": quote["id"],
    "customer": {"firstName": "Camille", "lastName": "Martin", "email": "camille@example.com"},
})["data"]

Ce que le client fait pour vous

Gestion des erreurs

from lexio_rent import ConflictError, RateLimitError, LexioError

try:
    lexio.rentals.create({"quoteId": quote_id})
except ConflictError as e:          # 409
    if e.code == "VEHICLE_UNAVAILABLE":
        ...
except RateLimitError as e:         # 429 après les nouvelles tentatives
    print("réessayer dans", e.retry_after, "s")
except LexioError as e:             # toute autre erreur de l'API
    print(e.status, e.code, e.detail, e.request_id)

Hiérarchie des exceptions : LexioError → AuthenticationError (401), PermissionDeniedError (403), NotFoundError (404), ConflictError (409), ValidationError (400, 413, 415, 422), RateLimitError (429), ServerError (5xx).

Ressources disponibles

Chaque méthode porte en docstring le résumé et la description de l'opération OpenAPI correspondante (help(lexio.rentals.create)). Une opération pas encore couverte reste accessible avec lexio.request("GET", "/chemin", params=...).

Suivre les changements (polling d'événements)

L'API n'a pas de webhooks. On lit le flux /events avec un curseur que l'on conserve :

cursor = load_cursor()  # None la première fois
page = lexio.events.list(cursor=cursor) if cursor else lexio.events.list(start="EARLIEST")
for event in page["data"]:
    handle(event)
save_cursor(page["nextCursor"])

Exemple complet : examples/sync_events.py.

Développement

python scripts/generate.py      # régénère src/lexio_rent/_resources.py depuis spec/openapi.json
pip install -e ".[test]" && pytest

spec/openapi.json est une copie de la spécification publiée sur https://docs.lexio.rent/openapi.json (version 1.0.5).

À propos

Ce client est maintenu par l'équipe de Lexio Rent, logiciel de location de voitures. Si vous gérez encore votre parc dans un tableur, notre modèle gratuit de gestion de parc automobile sous Excel reprend les mêmes champs que l'API (immatriculation, kilométrage, échéances d'entretien), ce qui facilite l'import le jour où vous passez à l'API.

• Documentation de l'API : https://docs.lexio.rent
• Spécification OpenAPI : https://docs.lexio.rent/openapi.json
• Confidentialité : https://lexio.rent/politique-de-confidentialite
• Contact : contact@lexio.rent

Licence MIT.