> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lekalao.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vérifier une clé de licence

> Appelé chaque semaine par une installation auto-hébergée, sans jeton : la clé signée est sa propre preuve. Limité à 30 appels par minute.



## OpenAPI

````yaml /api-reference/openapi.fr.json post /api/v1/licences/check
openapi: 3.1.0
info:
  title: API Lekalao
  version: 1.0.0
  description: >-
    Tout ce que fait l'interface, votre application peut le faire aussi. Chaque
    appel porte un jeton d'API (Paramètres → Jetons d'API).
servers:
  - url: https://{host}
    description: Votre installation
    variables:
      host:
        default: lekalao.example.com
        description: Le domaine de votre Lekalao
security:
  - bearer: []
tags:
  - name: Listes
  - name: Abonnés
  - name: Tags
  - name: Segments
  - name: Imports
  - name: Modèles
  - name: Campagnes
  - name: Automatisations
  - name: E-mails transactionnels
  - name: Revenu
  - name: Plateforme
paths:
  /api/v1/licences/check:
    post:
      tags:
        - Plateforme
      summary: Vérifier une clé de licence
      description: >-
        Appelé chaque semaine par une installation auto-hébergée, sans jeton :
        la clé signée est sa propre preuve. Limité à 30 appels par minute.
      operationId: api.licences.check
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - key
                - instance
              properties:
                key:
                  type: string
                instance:
                  type: string
                  maxLength: 64
                domain:
                  type:
                    - string
                    - 'null'
                version:
                  type:
                    - string
                    - 'null'
      responses:
        '200':
          description: Clé valide.
          content:
            application/json:
              schema:
                type: object
                properties:
                  valid:
                    type: boolean
                  customer:
                    type: string
                  plan:
                    type:
                      - string
                      - 'null'
                  expires_at:
                    type:
                      - string
                      - 'null'
                    format: date
                  expired:
                    type: boolean
        '403':
          description: Clé révoquée.
          content:
            application/json:
              schema:
                type: object
                properties:
                  valid:
                    type: boolean
                  reason:
                    type: string
                    enum:
                      - revoked
        '422':
          description: Clé illisible ou mal signée.
          content:
            application/json:
              schema:
                type: object
                properties:
                  valid:
                    type: boolean
                  reason:
                    type: string
                    enum:
                      - invalid
      security: []
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: >-
        Jeton d'API. Aptitude « read » : routes GET seulement. « read + write »
        : toutes les routes.

````