**Versions de l’API** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=fr)

# Terminals

OpenAPI 3.0.3 · API 2.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v2",
    "description": "API"
  }
]
```

## Opérations

## GET /kiosks

Lister la configuration enregistrée des bornes de l’organisation et leurs diagnostics statiques

`list_kiosks`

Scope requis : `kiosks:read`, explicitement attribué et jamais inclus dans les scopes de lecture par défaut. Lit uniquement la configuration enregistrée des bornes de l’organisation authentifiée. Les clés restreintes à des campagnes sont refusées, même avec une restriction vide. L’id de borne est une identité métier opaque exacte, pas nécessairement un UUID, et jamais le slug de l’appareil, le UUID d’un paiement, un identifiant de lecteur ou de session visiteur. associationId n’est retourné qu’après résolution indépendante de l’association exacte dans cette organisation ; les références indisponibles restent null. model décrit les capacités du catalogue, jamais la santé du matériel détectée. configuration.readerMode décrit le chemin configuré TAP_TO_PAY ou WEB_READER ; paymentSetup CONFIGURED signifie seulement qu’un réglage de paiement est enregistré pour l’association, sans vérification prestataire. fingerprintEnabled est la capacité du modèle après le coupe-circuit enregistré par borne, pas un enrôlement biométrique ou la disponibilité d’un capteur. Les booléens, noms, générations, modèles et réglages de lecteur historiques absents ou invalides restent null ou UNKNOWN ; aucun ancien modèle n’est inventé. observation.status reste NOT_REPORTED et lastSeenAt/appVersion/readerReady restent null car le propriétaire audité n’a pas d’observation persistée de heartbeat ou version. Aucune conclusion n’est permise sur la connexion, la fraîcheur, le bon fonctionnement du matériel, le succès d’un paiement ou son règlement bancaire. diagnostics.issues contient des problèmes statiques de configuration enregistrée, pas des pannes observées en direct. Une liste issues vide ne prouve aucune disponibilité d’appareil. La lecture n’appelle aucun prestataire et ne fait aucun ping, réservation, paiement, reset, reboot, création de session, opération biométrique ou modification de configuration. Aucun slug/clé d’appareil, identifiant ou secret de prestataire/client/lecteur/localisation, gabarit d’empreinte, identité de donateur, journal, URL ou instantané privé brut n’est exposé. Pour le résultat d’un don, utiliser le UUID existant du paiement avec son outil de statut distinct et paiements:read ; un id de borne ne permet pas d’identifier un paiement actif. Les paramètres query inconnus et corps GET non vides sont refusés. L’authentification commune peut enregistrer l’utilisation de la clé API. Retourne une pagination par id croissant, limit 1–200 (défaut 50) ; réutiliser nextCursor sans modification dans la même organisation. Au plus 1000 bornes enregistrées peuvent être inspectées ; 409 KIOSK_INVENTORY_TOO_LARGE ne retourne aucun inventaire partiel. Les identités historiques mal formées ou dupliquées produisent 409 INVALID_KIOSK_HISTORY. Corriger les données source via le propriétaire autorisé avant de relire. Les changements concurrents ne forment pas un instantané. Aucun formulaire, campagne, cagnotte ou objet Louah n’est développé.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "kiosks:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "description": "Taille de page, entier 1–200, défaut 50.",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "description": "nextCursor opaque retourné par la liste des bornes de cette organisation ; réutiliser sans modification.",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 1024
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Page de l’inventaire enregistré avec absence explicite d’observations en direct.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadListResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_KIOSK_ID, INVALID_LIMIT, INVALID_CURSOR, UNEXPECTED_QUERY_PARAMETERS ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, organisation désactivée ou CAMPAIGN_RESTRICTED_KEY. Ne pas contourner cette frontière d’accès.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_KIOSK_HISTORY ou KIOSK_INVENTORY_TOO_LARGE. Aucun inventaire incomplet n’est retourné.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR. Aucune opération d’appareil ou de paiement n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "kiosks:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## GET /kiosks/{id}

Lire la configuration enregistrée d’une borne et ses diagnostics statiques

`get_kiosk`

Scope requis : `kiosks:read`, explicitement attribué et jamais inclus dans les scopes de lecture par défaut. Lit uniquement la configuration enregistrée des bornes de l’organisation authentifiée. Les clés restreintes à des campagnes sont refusées, même avec une restriction vide. L’id de borne est une identité métier opaque exacte, pas nécessairement un UUID, et jamais le slug de l’appareil, le UUID d’un paiement, un identifiant de lecteur ou de session visiteur. associationId n’est retourné qu’après résolution indépendante de l’association exacte dans cette organisation ; les références indisponibles restent null. model décrit les capacités du catalogue, jamais la santé du matériel détectée. configuration.readerMode décrit le chemin configuré TAP_TO_PAY ou WEB_READER ; paymentSetup CONFIGURED signifie seulement qu’un réglage de paiement est enregistré pour l’association, sans vérification prestataire. fingerprintEnabled est la capacité du modèle après le coupe-circuit enregistré par borne, pas un enrôlement biométrique ou la disponibilité d’un capteur. Les booléens, noms, générations, modèles et réglages de lecteur historiques absents ou invalides restent null ou UNKNOWN ; aucun ancien modèle n’est inventé. observation.status reste NOT_REPORTED et lastSeenAt/appVersion/readerReady restent null car le propriétaire audité n’a pas d’observation persistée de heartbeat ou version. Aucune conclusion n’est permise sur la connexion, la fraîcheur, le bon fonctionnement du matériel, le succès d’un paiement ou son règlement bancaire. diagnostics.issues contient des problèmes statiques de configuration enregistrée, pas des pannes observées en direct. Une liste issues vide ne prouve aucune disponibilité d’appareil. La lecture n’appelle aucun prestataire et ne fait aucun ping, réservation, paiement, reset, reboot, création de session, opération biométrique ou modification de configuration. Aucun slug/clé d’appareil, identifiant ou secret de prestataire/client/lecteur/localisation, gabarit d’empreinte, identité de donateur, journal, URL ou instantané privé brut n’est exposé. Pour le résultat d’un don, utiliser le UUID existant du paiement avec son outil de statut distinct et paiements:read ; un id de borne ne permet pas d’identifier un paiement actif. Les paramètres query inconnus et corps GET non vides sont refusés. L’authentification commune peut enregistrer l’utilisation de la clé API. Utiliser l’id exact retourné par list_kiosks. Les objets absents, supprimés, avec une identité enregistrée mal formée ou appartenant à une autre organisation produisent le même 404. Cette lecture ne résout aucune session active de visiteur/paiement. Un 404 ne prouve pas qu’aucun don n’a eu lieu. Cette lecture ne modifie pas la configuration et ne contrôle aucun appareil.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "kiosks:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "Id métier exact de borne retourné par list_kiosks ; jamais un slug d’appareil ou un id de paiement.",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 128,
    "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Configuration enregistrée de la borne avec ses diagnostics statiques.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_KIOSK_ID, INVALID_LIMIT, INVALID_CURSOR, UNEXPECTED_QUERY_PARAMETERS ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, organisation désactivée ou CAMPAIGN_RESTRICTED_KEY. Ne pas contourner cette frontière d’accès.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : absence, suppression, identité enregistrée invalide ou autre organisation. Ce n’est pas un résultat de paiement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR. Aucune opération d’appareil ou de paiement n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "kiosks:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## GET /kiosks/{id}/config

Lire les réglages métier éditables d’une borne et leur révision de snapshot

`get_kiosk_config`

Configuration métier uniquement, sans firmware, administration d’appareil, routage de lecteur, secrets de paiement ni biométrie. Les frontières d’organisation/campagne restent celles de l’inventaire. caisses:read est également requis ; les écritures exigent aussi kiosks:read et l’attribution explicite kiosks:write. Appeler d’abord get_kiosk_config et fournir sa revision exacte dans expectedRevision. Seuls les champs fournis dans patch changent ; les tableaux remplacent leur ensemble ordonné complet. defaultPresetButtons utilise montant en unités MAJEURES, avec au plus deux décimales : 12.34 signifie 12.34 unités de devise, pas 1234. Au plus 12 presets sont admis, chacun entre 1–1000000 ; [] réactive le repli du consommateur (les presets de cagnotte sont prioritaires sur ceux de la borne). currency est la devise enregistrée de l’organisation utilisée par le chemin natif classique de don ; une devise inconnue interdit la modification des presets. manualCaisses contient au plus 50 UUIDs/null uniques ; null désigne le don général. Chaque cagnotte est admise indépendamment dans la source et la vue dérivée, cette organisation et l’association exacte de la borne, et doit être visible/active, avec objectif non épuisé selon les règles enregistrées du propriétaire. Aucun total de paiement n’est recalculé. MANUAL avec [] peut toujours afficher le don général via le repli natif du consommateur ; cela ne désactive pas les dons. AUTO restaure la sélection automatique sans effacer une liste manuelle enregistrée. Seuls les fichiers médias déjà hébergés pour cette organisation et admis par le propriétaire média sont acceptés, jamais une URL arbitraire, un chemin ou un téléchargement distant. backgroundVideo, footerText, shabbatWallpaper et shabbatPosterOnly exigent v2:true enregistré ; shabbatScreen 1–8 et emergencyType NONE/SHABBAT/ALL exigent v2:false enregistré. Une autre génération ou une génération inconnue refuse ces champs. Un affichage affiche seule sans image suit le repli natif, sans garantir un écran vide. ledConfig utilise le validateur natif d’éclairage adapté au modèle ; null restaure les valeurs par défaut natives. Lire lighting pour les modes, vitesses, secondes et intensité 0–100 admis ; une séquence exige 2–12 étapes de 0.5–3600 secondes. Un modèle non pris en charge retourne LED_NOT_SUPPORTED ; aucune commande matérielle n’est envoyée. L’association, les formulaires, produits, liaison Louah, modèle, lecteur et champs d’empreinte ne sont pas modifiables. Les champs inconnus et paramètres query non vides sont refusés. Une révision de snapshot exacte et un compare-and-set sur un seul document protègent la sauvegarde contre les changements intervenus sur la borne ; ce n’est pas un verrou transactionnel sur les associations, cagnottes, médias ou parcours internes. La configuration sauvegardée est RECORDED avec applicationStatus NOT_OBSERVED ; aucune application sur l’appareil, actualisation, présence ou disponibilité n’est garantie. Ne jamais réessayer aveuglément après une sauvegarde incertaine : relire get_kiosk_config et comparer les champs demandés et la révision. Aucune création de paiement/session, débit, réservation, opération biométrique, reset ou reboot n’est effectué. Lecture seule : retourne les réglages enregistrés, revision et unavailableFields. Les valeurs historiques invalides ou inaccessibles valent null et sont nommées dans unavailableFields ; les réglages absents/réinitialisés peuvent aussi valoir null sans cette mention. Aucun repli du consommateur n’est fabriqué dans les valeurs sauvegardées. La disponibilité des médias et l’éligibilité des cagnottes sont lues lors de l’admission. Aucun appel d’appareil ou de prestataire n’est effectué.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "kiosks:read",
  "additional": [
    "caisses:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "Id métier exact de borne retourné par list_kiosks ; jamais un slug d’appareil ou un id de paiement.",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 128,
    "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réglages éditables enregistrés, champs inconnus et révision optimiste.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskConfigResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_KIOSK_ID, INVALID_LIMIT, INVALID_CURSOR, UNEXPECTED_QUERY_PARAMETERS ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, organisation désactivée ou CAMPAIGN_RESTRICTED_KEY. Ne pas contourner cette frontière d’accès.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : borne absente, supprimée ou inaccessible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "KIOSK_REVISION_CONFLICT, INVALID_KIOSK_HISTORY, KIOSK_ASSOCIATION_UNAVAILABLE, KIOSK_CURRENCY_UNKNOWN, KIOSK_CAISSE_UNAVAILABLE, KIOSK_MEDIA_UNAVAILABLE, KIOSK_GENERATION_UNSUPPORTED ou LED_NOT_SUPPORTED. Relire et traiter le préalable du propriétaire pris en charge ; ne pas le contourner.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR. Aucune opération d’appareil ou de paiement n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "kiosks:read",
  "x-unisoft-additional-scopes": [
    "caisses:read"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## PATCH /kiosks/{id}/config

Enregistrer les réglages métier choisis d’une borne avec une révision exacte

`update_kiosk_config`

Configuration métier uniquement, sans firmware, administration d’appareil, routage de lecteur, secrets de paiement ni biométrie. Les frontières d’organisation/campagne restent celles de l’inventaire. caisses:read est également requis ; les écritures exigent aussi kiosks:read et l’attribution explicite kiosks:write. Appeler d’abord get_kiosk_config et fournir sa revision exacte dans expectedRevision. Seuls les champs fournis dans patch changent ; les tableaux remplacent leur ensemble ordonné complet. defaultPresetButtons utilise montant en unités MAJEURES, avec au plus deux décimales : 12.34 signifie 12.34 unités de devise, pas 1234. Au plus 12 presets sont admis, chacun entre 1–1000000 ; [] réactive le repli du consommateur (les presets de cagnotte sont prioritaires sur ceux de la borne). currency est la devise enregistrée de l’organisation utilisée par le chemin natif classique de don ; une devise inconnue interdit la modification des presets. manualCaisses contient au plus 50 UUIDs/null uniques ; null désigne le don général. Chaque cagnotte est admise indépendamment dans la source et la vue dérivée, cette organisation et l’association exacte de la borne, et doit être visible/active, avec objectif non épuisé selon les règles enregistrées du propriétaire. Aucun total de paiement n’est recalculé. MANUAL avec [] peut toujours afficher le don général via le repli natif du consommateur ; cela ne désactive pas les dons. AUTO restaure la sélection automatique sans effacer une liste manuelle enregistrée. Seuls les fichiers médias déjà hébergés pour cette organisation et admis par le propriétaire média sont acceptés, jamais une URL arbitraire, un chemin ou un téléchargement distant. backgroundVideo, footerText, shabbatWallpaper et shabbatPosterOnly exigent v2:true enregistré ; shabbatScreen 1–8 et emergencyType NONE/SHABBAT/ALL exigent v2:false enregistré. Une autre génération ou une génération inconnue refuse ces champs. Un affichage affiche seule sans image suit le repli natif, sans garantir un écran vide. ledConfig utilise le validateur natif d’éclairage adapté au modèle ; null restaure les valeurs par défaut natives. Lire lighting pour les modes, vitesses, secondes et intensité 0–100 admis ; une séquence exige 2–12 étapes de 0.5–3600 secondes. Un modèle non pris en charge retourne LED_NOT_SUPPORTED ; aucune commande matérielle n’est envoyée. L’association, les formulaires, produits, liaison Louah, modèle, lecteur et champs d’empreinte ne sont pas modifiables. Les champs inconnus et paramètres query non vides sont refusés. Une révision de snapshot exacte et un compare-and-set sur un seul document protègent la sauvegarde contre les changements intervenus sur la borne ; ce n’est pas un verrou transactionnel sur les associations, cagnottes, médias ou parcours internes. La configuration sauvegardée est RECORDED avec applicationStatus NOT_OBSERVED ; aucune application sur l’appareil, actualisation, présence ou disponibilité n’est garantie. Ne jamais réessayer aveuglément après une sauvegarde incertaine : relire get_kiosk_config et comparer les champs demandés et la révision. Aucune création de paiement/session, débit, réservation, opération biométrique, reset ou reboot n’est effectué. Écrit uniquement le $set exact autorisé du propriétaire natif bornes après admission de tous les champs et références fournis. Aucun upsert ni nouvelle borne n’est créé. ledConfig est normalisé par son propriétaire existant. Un résultat de persistance perdu/non acquitté retourne 503 KIOSK_UPDATE_UNCERTAIN ; le succès est acquitté directement, sans relecture accessoire susceptible de transformer une sauvegarde acquise en échec générique. Lire la configuration actuelle avant de décider d’un réessai.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "kiosks:write",
  "additional": [
    "kiosks:read",
    "caisses:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "Id métier exact de borne retourné par list_kiosks ; jamais un slug d’appareil ou un id de paiement.",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 128,
    "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "patch": {
            "$ref": "#/components/schemas/UnisoftRequest_7e96619eb715ceb59d37"
          }
        },
        "required": [
          "expectedRevision",
          "patch"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Configuration enregistrée et acquittée uniquement ; son application par l’appareil reste NOT_OBSERVED.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskConfigWriteResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_KIOSK_CONFIG, INVALID_LED_CONFIG, INVALID_KIOSK_ID ou UNEXPECTED_QUERY_PARAMETERS. Aucun réglage n’a été enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, organisation désactivée ou CAMPAIGN_RESTRICTED_KEY. Ne pas contourner cette frontière d’accès.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : borne absente, supprimée ou inaccessible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "KIOSK_REVISION_CONFLICT, INVALID_KIOSK_HISTORY, KIOSK_ASSOCIATION_UNAVAILABLE, KIOSK_CURRENCY_UNKNOWN, KIOSK_CAISSE_UNAVAILABLE, KIOSK_MEDIA_UNAVAILABLE, KIOSK_GENERATION_UNSUPPORTED ou LED_NOT_SUPPORTED. Relire et traiter le préalable du propriétaire pris en charge ; ne pas le contourner.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR. Aucune opération d’appareil ou de paiement n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "KIOSK_UPDATE_UNCERTAIN : la sauvegarde peut avoir abouti. Lire les réglages actuels avant tout réessai ; ne jamais compenser par une action d’appareil ou de paiement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KioskReadError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "kiosks:write",
  "x-unisoft-additional-scopes": [
    "kiosks:read",
    "caisses:read"
  ],
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "KioskReadListResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "meta",
          "coverage"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/KioskReadRecord"
            },
            "maxItems": 200
          },
          "meta": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "count",
              "hasMore",
              "nextCursor"
            ],
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0,
                "maximum": 200
              },
              "hasMore": {
                "type": "boolean"
              },
              "nextCursor": {
                "type": "string",
                "nullable": true,
                "maxLength": 1024
              }
            }
          },
          "coverage": {
            "$ref": "#/components/schemas/KioskReadCoverage"
          }
        }
      },
      "KioskReadRecord": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "label",
          "active",
          "generation",
          "associationId",
          "model",
          "configuration",
          "observation",
          "diagnostics"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$",
            "maxLength": 128
          },
          "label": {
            "type": "string",
            "nullable": true,
            "maxLength": 100
          },
          "active": {
            "type": "boolean",
            "nullable": true
          },
          "generation": {
            "type": "string",
            "enum": [
              "V2",
              "LEGACY",
              null
            ],
            "nullable": true
          },
          "associationId": {
            "type": "string",
            "nullable": true,
            "maxLength": 128
          },
          "model": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "fingerprintSupported",
              "lightingSupported"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "fingerprintSupported": {
                "type": "boolean"
              },
              "lightingSupported": {
                "type": "boolean"
              }
            },
            "nullable": true
          },
          "configuration": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "readerMode",
              "fingerprintEnabled",
              "paymentSetup"
            ],
            "properties": {
              "readerMode": {
                "type": "string",
                "enum": [
                  "TAP_TO_PAY",
                  "WEB_READER",
                  null
                ],
                "nullable": true
              },
              "fingerprintEnabled": {
                "type": "boolean",
                "nullable": true
              },
              "paymentSetup": {
                "type": "string",
                "enum": [
                  "CONFIGURED",
                  "MISSING",
                  "UNKNOWN"
                ]
              }
            }
          },
          "observation": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "status",
              "lastSeenAt",
              "appVersion",
              "readerReady"
            ],
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "NOT_REPORTED"
                ]
              },
              "lastSeenAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "appVersion": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "readerReady": {
                "type": "boolean",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            }
          },
          "diagnostics": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "basis",
              "issues"
            ],
            "properties": {
              "basis": {
                "type": "string",
                "enum": [
                  "STORED_CONFIGURATION"
                ]
              },
              "issues": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "ASSOCIATION_UNRESOLVED",
                    "MODEL_UNKNOWN",
                    "READER_ROUTE_UNRESOLVED",
                    "PAYMENT_SETUP_MISSING",
                    "PAYMENT_SETUP_UNKNOWN",
                    "KIOSK_DISABLED"
                  ]
                },
                "uniqueItems": true
              }
            }
          }
        }
      },
      "KioskReadCoverage": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "source",
          "liveChecked",
          "limitations"
        ],
        "properties": {
          "source": {
            "type": "string",
            "enum": [
              "STORED_CONFIGURATION"
            ]
          },
          "liveChecked": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "limitations": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "NO_HEARTBEAT_OWNER",
                "NO_LIVE_READER_CHECK",
                "NO_DEVICE_LOGS",
                "NO_PAYMENT_SESSION"
              ]
            },
            "uniqueItems": true
          }
        }
      },
      "KioskReadError": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      },
      "KioskReadResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "coverage"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/KioskReadRecord"
          },
          "coverage": {
            "$ref": "#/components/schemas/KioskReadCoverage"
          }
        }
      },
      "KioskConfigResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/KioskConfigRecord"
          }
        }
      },
      "KioskConfigRecord": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "revision",
          "currency",
          "settings",
          "unavailableFields",
          "applicationStatus",
          "lighting"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
          },
          "revision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "nullable": true
          },
          "settings": {
            "$ref": "#/components/schemas/KioskBusinessSettings"
          },
          "unavailableFields": {
            "type": "array",
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "label",
                "customWallpaper",
                "backgroundVideo",
                "footerText",
                "defaultPresetButtons",
                "caisseSystem",
                "manualCaisses",
                "autoShabbat",
                "shabbatWallpaper",
                "shabbatPosterOnly",
                "shabbatScreen",
                "emergencyType",
                "ledConfig"
              ]
            }
          },
          "applicationStatus": {
            "type": "string",
            "enum": [
              "NOT_OBSERVED"
            ]
          },
          "lighting": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "supported",
              "modes",
              "speeds",
              "limits",
              "defaults"
            ],
            "properties": {
              "supported": {
                "type": "boolean"
              },
              "modes": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "off",
                    "solid",
                    "blinkSlow",
                    "blinkFast",
                    "sequence",
                    "breathing",
                    "chasing",
                    "rainbow"
                  ]
                }
              },
              "speeds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "slow",
                    "normal",
                    "fast"
                  ]
                }
              },
              "limits": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "minSteps",
                  "maxSteps",
                  "minDurationSeconds",
                  "maxDurationSeconds"
                ],
                "properties": {
                  "minSteps": {
                    "type": "integer"
                  },
                  "maxSteps": {
                    "type": "integer"
                  },
                  "minDurationSeconds": {
                    "type": "number"
                  },
                  "maxDurationSeconds": {
                    "type": "number"
                  }
                },
                "nullable": true
              },
              "defaults": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "version",
                  "states"
                ],
                "properties": {
                  "version": {
                    "type": "integer",
                    "enum": [
                      1
                    ]
                  },
                  "states": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "standby": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                          "mode",
                          "color",
                          "intensity"
                        ],
                        "properties": {
                          "mode": {
                            "type": "string",
                            "enum": [
                              "off",
                              "solid",
                              "blinkSlow",
                              "blinkFast",
                              "sequence",
                              "breathing",
                              "chasing",
                              "rainbow"
                            ]
                          },
                          "color": {
                            "type": "string",
                            "pattern": "^#[0-9A-Fa-f]{6}$"
                          },
                          "intensity": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 100
                          },
                          "steps": {
                            "type": "array",
                            "maxItems": 12,
                            "items": {
                              "type": "object",
                              "additionalProperties": false,
                              "required": [
                                "color",
                                "durationSeconds"
                              ],
                              "properties": {
                                "color": {
                                  "type": "string",
                                  "pattern": "^#[0-9A-Fa-f]{6}$"
                                },
                                "durationSeconds": {
                                  "type": "number",
                                  "minimum": 0.5,
                                  "maximum": 3600
                                }
                              }
                            }
                          },
                          "speed": {
                            "type": "string",
                            "enum": [
                              "slow",
                              "normal",
                              "fast"
                            ]
                          }
                        }
                      },
                      "preparing": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                          "mode",
                          "color",
                          "intensity"
                        ],
                        "properties": {
                          "mode": {
                            "type": "string",
                            "enum": [
                              "off",
                              "solid",
                              "blinkSlow",
                              "blinkFast",
                              "sequence",
                              "breathing",
                              "chasing",
                              "rainbow"
                            ]
                          },
                          "color": {
                            "type": "string",
                            "pattern": "^#[0-9A-Fa-f]{6}$"
                          },
                          "intensity": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 100
                          },
                          "steps": {
                            "type": "array",
                            "maxItems": 12,
                            "items": {
                              "type": "object",
                              "additionalProperties": false,
                              "required": [
                                "color",
                                "durationSeconds"
                              ],
                              "properties": {
                                "color": {
                                  "type": "string",
                                  "pattern": "^#[0-9A-Fa-f]{6}$"
                                },
                                "durationSeconds": {
                                  "type": "number",
                                  "minimum": 0.5,
                                  "maximum": 3600
                                }
                              }
                            }
                          },
                          "speed": {
                            "type": "string",
                            "enum": [
                              "slow",
                              "normal",
                              "fast"
                            ]
                          }
                        }
                      },
                      "waitingCard": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                          "mode",
                          "color",
                          "intensity"
                        ],
                        "properties": {
                          "mode": {
                            "type": "string",
                            "enum": [
                              "off",
                              "solid",
                              "blinkSlow",
                              "blinkFast",
                              "sequence",
                              "breathing",
                              "chasing",
                              "rainbow"
                            ]
                          },
                          "color": {
                            "type": "string",
                            "pattern": "^#[0-9A-Fa-f]{6}$"
                          },
                          "intensity": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 100
                          },
                          "steps": {
                            "type": "array",
                            "maxItems": 12,
                            "items": {
                              "type": "object",
                              "additionalProperties": false,
                              "required": [
                                "color",
                                "durationSeconds"
                              ],
                              "properties": {
                                "color": {
                                  "type": "string",
                                  "pattern": "^#[0-9A-Fa-f]{6}$"
                                },
                                "durationSeconds": {
                                  "type": "number",
                                  "minimum": 0.5,
                                  "maximum": 3600
                                }
                              }
                            }
                          },
                          "speed": {
                            "type": "string",
                            "enum": [
                              "slow",
                              "normal",
                              "fast"
                            ]
                          }
                        }
                      },
                      "success": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                          "mode",
                          "color",
                          "intensity"
                        ],
                        "properties": {
                          "mode": {
                            "type": "string",
                            "enum": [
                              "off",
                              "solid",
                              "blinkSlow",
                              "blinkFast",
                              "sequence",
                              "breathing",
                              "chasing",
                              "rainbow"
                            ]
                          },
                          "color": {
                            "type": "string",
                            "pattern": "^#[0-9A-Fa-f]{6}$"
                          },
                          "intensity": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 100
                          },
                          "steps": {
                            "type": "array",
                            "maxItems": 12,
                            "items": {
                              "type": "object",
                              "additionalProperties": false,
                              "required": [
                                "color",
                                "durationSeconds"
                              ],
                              "properties": {
                                "color": {
                                  "type": "string",
                                  "pattern": "^#[0-9A-Fa-f]{6}$"
                                },
                                "durationSeconds": {
                                  "type": "number",
                                  "minimum": 0.5,
                                  "maximum": 3600
                                }
                              }
                            }
                          },
                          "speed": {
                            "type": "string",
                            "enum": [
                              "slow",
                              "normal",
                              "fast"
                            ]
                          }
                        }
                      },
                      "error": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                          "mode",
                          "color",
                          "intensity"
                        ],
                        "properties": {
                          "mode": {
                            "type": "string",
                            "enum": [
                              "off",
                              "solid",
                              "blinkSlow",
                              "blinkFast",
                              "sequence",
                              "breathing",
                              "chasing",
                              "rainbow"
                            ]
                          },
                          "color": {
                            "type": "string",
                            "pattern": "^#[0-9A-Fa-f]{6}$"
                          },
                          "intensity": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 100
                          },
                          "steps": {
                            "type": "array",
                            "maxItems": 12,
                            "items": {
                              "type": "object",
                              "additionalProperties": false,
                              "required": [
                                "color",
                                "durationSeconds"
                              ],
                              "properties": {
                                "color": {
                                  "type": "string",
                                  "pattern": "^#[0-9A-Fa-f]{6}$"
                                },
                                "durationSeconds": {
                                  "type": "number",
                                  "minimum": 0.5,
                                  "maximum": 3600
                                }
                              }
                            }
                          },
                          "speed": {
                            "type": "string",
                            "enum": [
                              "slow",
                              "normal",
                              "fast"
                            ]
                          }
                        }
                      },
                      "shabbat": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                          "mode",
                          "color",
                          "intensity"
                        ],
                        "properties": {
                          "mode": {
                            "type": "string",
                            "enum": [
                              "off",
                              "solid",
                              "blinkSlow",
                              "blinkFast",
                              "sequence",
                              "breathing",
                              "chasing",
                              "rainbow"
                            ]
                          },
                          "color": {
                            "type": "string",
                            "pattern": "^#[0-9A-Fa-f]{6}$"
                          },
                          "intensity": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 100
                          },
                          "steps": {
                            "type": "array",
                            "maxItems": 12,
                            "items": {
                              "type": "object",
                              "additionalProperties": false,
                              "required": [
                                "color",
                                "durationSeconds"
                              ],
                              "properties": {
                                "color": {
                                  "type": "string",
                                  "pattern": "^#[0-9A-Fa-f]{6}$"
                                },
                                "durationSeconds": {
                                  "type": "number",
                                  "minimum": 0.5,
                                  "maximum": 3600
                                }
                              }
                            }
                          },
                          "speed": {
                            "type": "string",
                            "enum": [
                              "slow",
                              "normal",
                              "fast"
                            ]
                          }
                        }
                      }
                    }
                  }
                },
                "nullable": true
              }
            }
          }
        }
      },
      "KioskBusinessSettings": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "label",
          "customWallpaper",
          "backgroundVideo",
          "shabbatWallpaper",
          "footerText",
          "defaultPresetButtons",
          "caisseSystem",
          "manualCaisses",
          "autoShabbat",
          "shabbatPosterOnly",
          "shabbatScreen",
          "emergencyType",
          "ledConfig"
        ],
        "properties": {
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "nullable": true
          },
          "customWallpaper": {
            "type": "string",
            "nullable": true,
            "minLength": 1,
            "maxLength": 200,
            "pattern": "^(?!.*\\.\\.)[A-Za-z0-9][A-Za-z0-9._-]*\\.[A-Za-z0-9]+$"
          },
          "backgroundVideo": {
            "type": "string",
            "nullable": true,
            "minLength": 1,
            "maxLength": 200,
            "pattern": "^(?!.*\\.\\.)[A-Za-z0-9][A-Za-z0-9._-]*\\.[A-Za-z0-9]+$"
          },
          "shabbatWallpaper": {
            "type": "string",
            "nullable": true,
            "minLength": 1,
            "maxLength": 200,
            "pattern": "^(?!.*\\.\\.)[A-Za-z0-9][A-Za-z0-9._-]*\\.[A-Za-z0-9]+$"
          },
          "footerText": {
            "type": "string",
            "nullable": true,
            "maxLength": 200
          },
          "defaultPresetButtons": {
            "type": "array",
            "maxItems": 12,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "montant"
              ],
              "properties": {
                "montant": {
                  "type": "number",
                  "minimum": 1,
                  "maximum": 1000000,
                  "multipleOf": 0.01
                },
                "text": {
                  "type": "string",
                  "maxLength": 100
                }
              }
            },
            "nullable": true
          },
          "caisseSystem": {
            "type": "string",
            "enum": [
              "AUTO",
              "MANUAL",
              null
            ],
            "nullable": true
          },
          "manualCaisses": {
            "type": "array",
            "maxItems": 50,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "uuid",
              "nullable": true
            },
            "nullable": true
          },
          "autoShabbat": {
            "type": "boolean",
            "nullable": true
          },
          "shabbatPosterOnly": {
            "type": "boolean",
            "nullable": true
          },
          "shabbatScreen": {
            "type": "integer",
            "minimum": 1,
            "maximum": 8,
            "nullable": true
          },
          "emergencyType": {
            "type": "string",
            "enum": [
              "NONE",
              "SHABBAT",
              "ALL",
              null
            ],
            "nullable": true
          },
          "ledConfig": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "version",
              "states"
            ],
            "properties": {
              "version": {
                "type": "integer",
                "enum": [
                  1
                ]
              },
              "states": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "standby": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "mode",
                      "color",
                      "intensity"
                    ],
                    "properties": {
                      "mode": {
                        "type": "string",
                        "enum": [
                          "off",
                          "solid",
                          "blinkSlow",
                          "blinkFast",
                          "sequence",
                          "breathing",
                          "chasing",
                          "rainbow"
                        ]
                      },
                      "color": {
                        "type": "string",
                        "pattern": "^#[0-9A-Fa-f]{6}$"
                      },
                      "intensity": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100
                      },
                      "steps": {
                        "type": "array",
                        "maxItems": 12,
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "color",
                            "durationSeconds"
                          ],
                          "properties": {
                            "color": {
                              "type": "string",
                              "pattern": "^#[0-9A-Fa-f]{6}$"
                            },
                            "durationSeconds": {
                              "type": "number",
                              "minimum": 0.5,
                              "maximum": 3600
                            }
                          }
                        }
                      },
                      "speed": {
                        "type": "string",
                        "enum": [
                          "slow",
                          "normal",
                          "fast"
                        ]
                      }
                    }
                  },
                  "preparing": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "mode",
                      "color",
                      "intensity"
                    ],
                    "properties": {
                      "mode": {
                        "type": "string",
                        "enum": [
                          "off",
                          "solid",
                          "blinkSlow",
                          "blinkFast",
                          "sequence",
                          "breathing",
                          "chasing",
                          "rainbow"
                        ]
                      },
                      "color": {
                        "type": "string",
                        "pattern": "^#[0-9A-Fa-f]{6}$"
                      },
                      "intensity": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100
                      },
                      "steps": {
                        "type": "array",
                        "maxItems": 12,
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "color",
                            "durationSeconds"
                          ],
                          "properties": {
                            "color": {
                              "type": "string",
                              "pattern": "^#[0-9A-Fa-f]{6}$"
                            },
                            "durationSeconds": {
                              "type": "number",
                              "minimum": 0.5,
                              "maximum": 3600
                            }
                          }
                        }
                      },
                      "speed": {
                        "type": "string",
                        "enum": [
                          "slow",
                          "normal",
                          "fast"
                        ]
                      }
                    }
                  },
                  "waitingCard": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "mode",
                      "color",
                      "intensity"
                    ],
                    "properties": {
                      "mode": {
                        "type": "string",
                        "enum": [
                          "off",
                          "solid",
                          "blinkSlow",
                          "blinkFast",
                          "sequence",
                          "breathing",
                          "chasing",
                          "rainbow"
                        ]
                      },
                      "color": {
                        "type": "string",
                        "pattern": "^#[0-9A-Fa-f]{6}$"
                      },
                      "intensity": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100
                      },
                      "steps": {
                        "type": "array",
                        "maxItems": 12,
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "color",
                            "durationSeconds"
                          ],
                          "properties": {
                            "color": {
                              "type": "string",
                              "pattern": "^#[0-9A-Fa-f]{6}$"
                            },
                            "durationSeconds": {
                              "type": "number",
                              "minimum": 0.5,
                              "maximum": 3600
                            }
                          }
                        }
                      },
                      "speed": {
                        "type": "string",
                        "enum": [
                          "slow",
                          "normal",
                          "fast"
                        ]
                      }
                    }
                  },
                  "success": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "mode",
                      "color",
                      "intensity"
                    ],
                    "properties": {
                      "mode": {
                        "type": "string",
                        "enum": [
                          "off",
                          "solid",
                          "blinkSlow",
                          "blinkFast",
                          "sequence",
                          "breathing",
                          "chasing",
                          "rainbow"
                        ]
                      },
                      "color": {
                        "type": "string",
                        "pattern": "^#[0-9A-Fa-f]{6}$"
                      },
                      "intensity": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100
                      },
                      "steps": {
                        "type": "array",
                        "maxItems": 12,
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "color",
                            "durationSeconds"
                          ],
                          "properties": {
                            "color": {
                              "type": "string",
                              "pattern": "^#[0-9A-Fa-f]{6}$"
                            },
                            "durationSeconds": {
                              "type": "number",
                              "minimum": 0.5,
                              "maximum": 3600
                            }
                          }
                        }
                      },
                      "speed": {
                        "type": "string",
                        "enum": [
                          "slow",
                          "normal",
                          "fast"
                        ]
                      }
                    }
                  },
                  "error": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "mode",
                      "color",
                      "intensity"
                    ],
                    "properties": {
                      "mode": {
                        "type": "string",
                        "enum": [
                          "off",
                          "solid",
                          "blinkSlow",
                          "blinkFast",
                          "sequence",
                          "breathing",
                          "chasing",
                          "rainbow"
                        ]
                      },
                      "color": {
                        "type": "string",
                        "pattern": "^#[0-9A-Fa-f]{6}$"
                      },
                      "intensity": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100
                      },
                      "steps": {
                        "type": "array",
                        "maxItems": 12,
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "color",
                            "durationSeconds"
                          ],
                          "properties": {
                            "color": {
                              "type": "string",
                              "pattern": "^#[0-9A-Fa-f]{6}$"
                            },
                            "durationSeconds": {
                              "type": "number",
                              "minimum": 0.5,
                              "maximum": 3600
                            }
                          }
                        }
                      },
                      "speed": {
                        "type": "string",
                        "enum": [
                          "slow",
                          "normal",
                          "fast"
                        ]
                      }
                    }
                  },
                  "shabbat": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "mode",
                      "color",
                      "intensity"
                    ],
                    "properties": {
                      "mode": {
                        "type": "string",
                        "enum": [
                          "off",
                          "solid",
                          "blinkSlow",
                          "blinkFast",
                          "sequence",
                          "breathing",
                          "chasing",
                          "rainbow"
                        ]
                      },
                      "color": {
                        "type": "string",
                        "pattern": "^#[0-9A-Fa-f]{6}$"
                      },
                      "intensity": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100
                      },
                      "steps": {
                        "type": "array",
                        "maxItems": 12,
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "color",
                            "durationSeconds"
                          ],
                          "properties": {
                            "color": {
                              "type": "string",
                              "pattern": "^#[0-9A-Fa-f]{6}$"
                            },
                            "durationSeconds": {
                              "type": "number",
                              "minimum": 0.5,
                              "maximum": 3600
                            }
                          }
                        }
                      },
                      "speed": {
                        "type": "string",
                        "enum": [
                          "slow",
                          "normal",
                          "fast"
                        ]
                      }
                    }
                  }
                }
              }
            },
            "nullable": true
          }
        }
      },
      "UnisoftRequest_7e96619eb715ceb59d37": {
        "type": "object",
        "minProperties": 1,
        "properties": {
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "customWallpaper": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "pattern": "^(?!.*\\.\\.)[A-Za-z0-9][A-Za-z0-9._-]*\\.[A-Za-z0-9]+$",
            "nullable": true
          },
          "backgroundVideo": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "pattern": "^(?!.*\\.\\.)[A-Za-z0-9][A-Za-z0-9._-]*\\.[A-Za-z0-9]+$",
            "nullable": true
          },
          "shabbatWallpaper": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "pattern": "^(?!.*\\.\\.)[A-Za-z0-9][A-Za-z0-9._-]*\\.[A-Za-z0-9]+$",
            "nullable": true
          },
          "footerText": {
            "type": "string",
            "maxLength": 200,
            "nullable": true
          },
          "defaultPresetButtons": {
            "type": "array",
            "maxItems": 12,
            "items": {
              "type": "object",
              "properties": {
                "montant": {
                  "type": "number",
                  "minimum": 1,
                  "maximum": 1000000,
                  "multipleOf": 0.01
                },
                "text": {
                  "type": "string",
                  "maxLength": 100
                }
              },
              "required": [
                "montant"
              ],
              "additionalProperties": false
            }
          },
          "caisseSystem": {
            "type": "string",
            "enum": [
              "AUTO",
              "MANUAL"
            ]
          },
          "manualCaisses": {
            "type": "array",
            "maxItems": 50,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "uuid",
              "nullable": true
            }
          },
          "autoShabbat": {
            "type": "boolean"
          },
          "shabbatPosterOnly": {
            "type": "boolean"
          },
          "shabbatScreen": {
            "type": "integer",
            "minimum": 1,
            "maximum": 8
          },
          "emergencyType": {
            "type": "string",
            "enum": [
              "NONE",
              "SHABBAT",
              "ALL"
            ]
          },
          "ledConfig": {
            "type": "object",
            "properties": {
              "version": {
                "type": "integer",
                "enum": [
                  1
                ]
              },
              "states": {
                "$ref": "#/components/schemas/UnisoftRequest_a7fd87b24b68e68ce878"
              }
            },
            "required": [
              "version",
              "states"
            ],
            "additionalProperties": false,
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "UnisoftRequest_a7fd87b24b68e68ce878": {
        "type": "object",
        "properties": {
          "standby": {
            "type": "object",
            "properties": {
              "mode": {
                "type": "string",
                "enum": [
                  "off",
                  "solid",
                  "blinkSlow",
                  "blinkFast",
                  "sequence",
                  "breathing",
                  "chasing",
                  "rainbow"
                ]
              },
              "color": {
                "type": "string",
                "pattern": "^#[0-9A-Fa-f]{6}$"
              },
              "intensity": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100
              },
              "steps": {
                "type": "array",
                "maxItems": 12,
                "items": {
                  "type": "object",
                  "properties": {
                    "color": {
                      "type": "string",
                      "pattern": "^#[0-9A-Fa-f]{6}$"
                    },
                    "durationSeconds": {
                      "type": "number",
                      "minimum": 0.5,
                      "maximum": 3600
                    }
                  },
                  "required": [
                    "color",
                    "durationSeconds"
                  ],
                  "additionalProperties": false
                }
              },
              "speed": {
                "type": "string",
                "enum": [
                  "slow",
                  "normal",
                  "fast"
                ]
              }
            },
            "required": [
              "mode",
              "color",
              "intensity"
            ],
            "additionalProperties": false
          },
          "preparing": {
            "type": "object",
            "properties": {
              "mode": {
                "type": "string",
                "enum": [
                  "off",
                  "solid",
                  "blinkSlow",
                  "blinkFast",
                  "sequence",
                  "breathing",
                  "chasing",
                  "rainbow"
                ]
              },
              "color": {
                "type": "string",
                "pattern": "^#[0-9A-Fa-f]{6}$"
              },
              "intensity": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100
              },
              "steps": {
                "type": "array",
                "maxItems": 12,
                "items": {
                  "type": "object",
                  "properties": {
                    "color": {
                      "type": "string",
                      "pattern": "^#[0-9A-Fa-f]{6}$"
                    },
                    "durationSeconds": {
                      "type": "number",
                      "minimum": 0.5,
                      "maximum": 3600
                    }
                  },
                  "required": [
                    "color",
                    "durationSeconds"
                  ],
                  "additionalProperties": false
                }
              },
              "speed": {
                "type": "string",
                "enum": [
                  "slow",
                  "normal",
                  "fast"
                ]
              }
            },
            "required": [
              "mode",
              "color",
              "intensity"
            ],
            "additionalProperties": false
          },
          "waitingCard": {
            "type": "object",
            "properties": {
              "mode": {
                "type": "string",
                "enum": [
                  "off",
                  "solid",
                  "blinkSlow",
                  "blinkFast",
                  "sequence",
                  "breathing",
                  "chasing",
                  "rainbow"
                ]
              },
              "color": {
                "type": "string",
                "pattern": "^#[0-9A-Fa-f]{6}$"
              },
              "intensity": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100
              },
              "steps": {
                "type": "array",
                "maxItems": 12,
                "items": {
                  "type": "object",
                  "properties": {
                    "color": {
                      "type": "string",
                      "pattern": "^#[0-9A-Fa-f]{6}$"
                    },
                    "durationSeconds": {
                      "type": "number",
                      "minimum": 0.5,
                      "maximum": 3600
                    }
                  },
                  "required": [
                    "color",
                    "durationSeconds"
                  ],
                  "additionalProperties": false
                }
              },
              "speed": {
                "type": "string",
                "enum": [
                  "slow",
                  "normal",
                  "fast"
                ]
              }
            },
            "required": [
              "mode",
              "color",
              "intensity"
            ],
            "additionalProperties": false
          },
          "success": {
            "type": "object",
            "properties": {
              "mode": {
                "type": "string",
                "enum": [
                  "off",
                  "solid",
                  "blinkSlow",
                  "blinkFast",
                  "sequence",
                  "breathing",
                  "chasing",
                  "rainbow"
                ]
              },
              "color": {
                "type": "string",
                "pattern": "^#[0-9A-Fa-f]{6}$"
              },
              "intensity": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100
              },
              "steps": {
                "type": "array",
                "maxItems": 12,
                "items": {
                  "type": "object",
                  "properties": {
                    "color": {
                      "type": "string",
                      "pattern": "^#[0-9A-Fa-f]{6}$"
                    },
                    "durationSeconds": {
                      "type": "number",
                      "minimum": 0.5,
                      "maximum": 3600
                    }
                  },
                  "required": [
                    "color",
                    "durationSeconds"
                  ],
                  "additionalProperties": false
                }
              },
              "speed": {
                "type": "string",
                "enum": [
                  "slow",
                  "normal",
                  "fast"
                ]
              }
            },
            "required": [
              "mode",
              "color",
              "intensity"
            ],
            "additionalProperties": false
          },
          "error": {
            "type": "object",
            "properties": {
              "mode": {
                "type": "string",
                "enum": [
                  "off",
                  "solid",
                  "blinkSlow",
                  "blinkFast",
                  "sequence",
                  "breathing",
                  "chasing",
                  "rainbow"
                ]
              },
              "color": {
                "type": "string",
                "pattern": "^#[0-9A-Fa-f]{6}$"
              },
              "intensity": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100
              },
              "steps": {
                "type": "array",
                "maxItems": 12,
                "items": {
                  "type": "object",
                  "properties": {
                    "color": {
                      "type": "string",
                      "pattern": "^#[0-9A-Fa-f]{6}$"
                    },
                    "durationSeconds": {
                      "type": "number",
                      "minimum": 0.5,
                      "maximum": 3600
                    }
                  },
                  "required": [
                    "color",
                    "durationSeconds"
                  ],
                  "additionalProperties": false
                }
              },
              "speed": {
                "type": "string",
                "enum": [
                  "slow",
                  "normal",
                  "fast"
                ]
              }
            },
            "required": [
              "mode",
              "color",
              "intensity"
            ],
            "additionalProperties": false
          },
          "shabbat": {
            "type": "object",
            "properties": {
              "mode": {
                "type": "string",
                "enum": [
                  "off",
                  "solid",
                  "blinkSlow",
                  "blinkFast",
                  "sequence",
                  "breathing",
                  "chasing",
                  "rainbow"
                ]
              },
              "color": {
                "type": "string",
                "pattern": "^#[0-9A-Fa-f]{6}$"
              },
              "intensity": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100
              },
              "steps": {
                "type": "array",
                "maxItems": 12,
                "items": {
                  "type": "object",
                  "properties": {
                    "color": {
                      "type": "string",
                      "pattern": "^#[0-9A-Fa-f]{6}$"
                    },
                    "durationSeconds": {
                      "type": "number",
                      "minimum": 0.5,
                      "maximum": 3600
                    }
                  },
                  "required": [
                    "color",
                    "durationSeconds"
                  ],
                  "additionalProperties": false
                }
              },
              "speed": {
                "type": "string",
                "enum": [
                  "slow",
                  "normal",
                  "fast"
                ]
              }
            },
            "required": [
              "mode",
              "color",
              "intensity"
            ],
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "KioskConfigWriteResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "revision",
              "state",
              "applicationStatus",
              "changedFields"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
              },
              "revision": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "state": {
                "type": "string",
                "enum": [
                  "RECORDED"
                ]
              },
              "applicationStatus": {
                "type": "string",
                "enum": [
                  "NOT_OBSERVED"
                ]
              },
              "changedFields": {
                "type": "array",
                "uniqueItems": true,
                "minItems": 1,
                "maxItems": 13,
                "items": {
                  "type": "string",
                  "enum": [
                    "label",
                    "customWallpaper",
                    "backgroundVideo",
                    "footerText",
                    "defaultPresetButtons",
                    "caisseSystem",
                    "manualCaisses",
                    "autoShabbat",
                    "shabbatWallpaper",
                    "shabbatPosterOnly",
                    "shabbatScreen",
                    "emergencyType",
                    "ledConfig"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
