> ## 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. # Enregistrer un événement, ou un lot > Consigne ce qu'une personne a fait : une commande, un panier laissé, une page vue. Les événements démarrent des automatisations (déclencheur **La personne fait quelque chose**), alimentent les segments, et un événement nommé `order` porteur d'une `value` est crédité comme revenu à l'e-mail qui l'a gagné. Envoyez un événement comme corps, ou jusqu'à 1 000 sous `events`. Dans un lot, chaque ligne reçoit sa propre réponse, dans l'ordre d'arrivée : une ligne fausse ne coûte rien aux autres. La personne n'a pas besoin d'être déjà abonnée : l'événement est gardé sous son adresse et rejoint son profil quand elle s'abonne. ## OpenAPI ````yaml /api-reference/openapi.fr.json post /v1/events 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://api.lekalao.com description: Lekalao - url: https://{host}/api description: Votre propre installation variables: host: default: lekalao.example.com description: Le domaine de votre installation 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: Champs de contact - name: Événements - name: Webhooks - name: Plateforme paths: /v1/events: post: tags: - Événements summary: Enregistrer un événement, ou un lot description: >- Consigne ce qu'une personne a fait : une commande, un panier laissé, une page vue. Les événements démarrent des automatisations (déclencheur **La personne fait quelque chose**), alimentent les segments, et un événement nommé `order` porteur d'une `value` est crédité comme revenu à l'e-mail qui l'a gagné. Envoyez un événement comme corps, ou jusqu'à 1 000 sous `events`. Dans un lot, chaque ligne reçoit sa propre réponse, dans l'ordre d'arrivée : une ligne fausse ne coûte rien aux autres. La personne n'a pas besoin d'être déjà abonnée : l'événement est gardé sous son adresse et rejoint son profil quand elle s'abonne. operationId: api.events.store parameters: - $ref: '#/components/parameters/IdempotencyKey' requestBody: required: true content: application/json: schema: oneOf: - $ref: '#/components/schemas/EventInput' - type: object required: - events properties: events: type: array minItems: 1 maxItems: 1000 items: $ref: '#/components/schemas/EventInput' example: email: ada@example.com name: order value: 15000 currency: XAF reference: CMD-1024 properties: items: - name: Darjeeling quantity: 2 responses: '200': description: >- Un événement dont la `reference` était déjà connue (`duplicate`), ou un lot : `data` porte un résultat par ligne et `failed` compte les invalides. content: application/json: schema: type: object properties: data: oneOf: - $ref: '#/components/schemas/EventResult' - type: array items: $ref: '#/components/schemas/EventResult' failed: type: integer '201': description: Enregistré (un événement). content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/EventResult' '401': $ref: '#/components/responses/Unauthenticated' '403': $ref: '#/components/responses/Forbidden' '422': description: >- L'événement est invalide — ou toutes les lignes du lot le sont. `errors` dit pourquoi, ligne par ligne. '429': $ref: '#/components/responses/TooManyRequests' components: parameters: IdempotencyKey: name: Idempotency-Key in: header required: false schema: type: string maxLength: 255 description: >- Rejouez une écriture sans risque : la même clé rend la première réponse pendant 24 heures (en-tête Idempotent-Replay: true). schemas: EventInput: type: object required: - email - name properties: email: type: string format: email name: type: string maxLength: 100 pattern: ^[A-Za-z0-9 _.:-]+$ example: cart.abandoned description: >- À vous de le choisir. `order` est compté comme du revenu ; `cart.abandoned` démarre le parcours de panier prêt à l'emploi. properties: type: - object - 'null' additionalProperties: true description: >- Ce qui le décrit. Disponible dans les e-mails de l'automatisation qu'il démarre, sous `{{ event.… }}`. value: type: - integer - 'null' minimum: 0 description: 'Dans la plus petite unité : 1250 vaut 12,50 €. Exige `currency`.' currency: type: - string - 'null' minLength: 3 maxLength: 3 occurred_at: type: - string - 'null' format: date-time description: Maintenant, si absent. Au plus un jour dans le futur. reference: type: - string - 'null' maxLength: 255 description: >- Votre propre identifiant — un numéro de commande. La même référence deux fois n'est enregistrée qu'une fois. EventResult: type: object properties: index: type: integer status: type: string enum: - recorded - duplicate - invalid id: type: string format: uuid errors: type: object additionalProperties: type: array items: type: string Message: type: object properties: message: type: string responses: Unauthenticated: description: Aucun jeton, ou un jeton invalide ou révoqué. content: application/json: schema: $ref: '#/components/schemas/Message' example: message: Unauthenticated. Forbidden: description: Le jeton n'a pas l'aptitude requise, ou l'équipe est suspendue. content: application/json: schema: $ref: '#/components/schemas/Message' TooManyRequests: description: >- Limite du jeton atteinte. Attendez le nombre de secondes indiqué par Retry-After. headers: X-RateLimit-Limit: schema: type: integer description: Appels permis par minute pour ce jeton. X-RateLimit-Remaining: schema: type: integer Retry-After: schema: type: integer securitySchemes: bearer: type: http scheme: bearer description: >- Jeton d'API. Aptitude « read » : routes GET seulement. « read + write » : toutes les routes. ````