Passer au contenu principal
PATCH
Modifier une option

Autorisations

Authorization
string
header
requis

Clé API lck_… créée dans Lexio (Paramètres → Développeur), envoyée en Authorization: Bearer. Voir Authentification.

En-têtes

Idempotency-Key
string

Clé unique de l’opération, réutilisée à chaque nouvel essai : un rejeu avec la même clé et le même corps renvoie la réponse initiale sans rien réécrire. Voir Idempotence.

Required string length: 1 - 255
Pattern: ^[\x20-\x7E]+$
Exemple:

"8b3e1d2c-4a5f-4c6b-9e7d-1f2a3b4c5d6e"

Paramètres de chemin

optionId
string<uuid>
requis

Identifiant de l’option.

Exemple:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

Corps

name
string

Nom affiché au client.

Required string length: 1 - 100
kind
enum<string>

STANDARD : option vendue à la quantité. ADDITIONAL_DRIVER : conducteur additionnel, réservable par une clé interne seulement. YOUNG_DRIVER : supplément jeune conducteur, appliqué par Lexio d’après l’âge des conducteurs, jamais demandé directement. Une seule option de chacun de ces deux derniers types par organisation. Changer kind sans envoyer maxQuantity le remet à 1.

Options disponibles:
STANDARD,
ADDITIONAL_DRIVER,
YOUNG_DRIVER
description
string | null

Description libre ; null si absente.

Maximum string length: 500
group
enum<string>

Rubrique d’affichage de l’option.

Options disponibles:
COMFORT,
PROTECTION,
ACCESSORIES,
DELIVERY,
SERVICES,
OTHER
maxQuantity
integer

Exemplaires au plus par location, pour une option STANDARD. Une option conducteur vaut toujours 1 ici et ne le fixe pas (400 not_applicable) : le conducteur additionnel se réserve jusqu’à 4 fois, borne lue dans choices.options[].maxBookableQuantity du devis.

Plage requise: 1 <= x <= 100
stockCount
integer

Exemplaires louables en même temps, toutes locations confondues ; ignoré pour une option conducteur. Le reste disponible sur une période se lit dans maxBookableQuantity du devis.

Plage requise: 1 <= x <= 1000
availableMonths
integer[]

Mois où l’option se vend (1 = janvier), chacun une fois : elle est proposée si la location touche l’un d’eux ; [] : toute l’année.

Maximum array length: 12
Plage requise: 1 <= x <= 12
youngDriverAgeThreshold
integer | null

Âge au départ en dessous duquel le supplément s’applique à un conducteur. Requis pour une option YOUNG_DRIVER (sinon 400 required) ; null pour les autres types, qui le refusent (400 not_applicable).

Plage requise: 16 <= x <= 99
isActive
boolean

false : option retirée de la vente.

displayOrder
integer

Rang d’affichage ; ordre de la liste.

Plage requise: 0 <= x <= 2147483647
price
object

Fusionné champ par champ avec le prix enregistré.

Réponse

Modifier une option

data
object
requis
Exemple: