> ## 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.
# Créer un modèle
> Un modèle porte la mise en page ; les campagnes remplissent sa zone éditable `{{ zone.main }}`.
## OpenAPI
````yaml /api-reference/openapi.fr.json post /api/v1/templates
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/templates:
post:
tags:
- Modèles
summary: Créer un modèle
description: >-
Un modèle porte la mise en page ; les campagnes remplissent sa zone
éditable `{{ zone.main }}`.
operationId: api.templates.store
parameters:
- $ref: '#/components/parameters/IdempotencyKey'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
- editor
properties:
name:
type: string
editor:
type: string
enum:
- blocks
- markdown
- html
- mjml
content:
type:
- string
- 'null'
styles:
type:
- string
- 'null'
description: CSS, 100 000 caractères au plus.
example:
name: Lettre mensuelle
editor: html
content: >-
{{ zone.main }}
responses:
'201':
description: Le modèle créé.
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/Template'
'401':
$ref: '#/components/responses/Unauthenticated'
'403':
$ref: '#/components/responses/Forbidden'
'422':
$ref: '#/components/responses/ValidationFailed'
'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:
Template:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
editor:
type: string
enum:
- blocks
- markdown
- html
- mjml
content:
type:
- string
- 'null'
description: Absent des listes paginées.
styles:
type:
- string
- 'null'
description: CSS inliné au rendu. Absent des listes paginées.
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
Message:
type: object
properties:
message:
type: string
ValidationError:
type: object
properties:
message:
type: string
example: Le champ email doit être une adresse e-mail valide.
errors:
type: object
additionalProperties:
type: array
items:
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'
ValidationFailed:
description: Données invalides.
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
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.
````