📝 Formulaire de test 🔤 Liste des polices disponibles 📂 Liste des templates disponibles

🔑 Authentification

Toutes les requêtes à l'API nécessitent une clé d'authentification incluse dans les headers HTTP. Cette clé doit être envoyée sous la forme suivante :

X-Frontend-Token: VOTRE_TOKEN_SECRET
            

⚠️ Attention : Ne partagez jamais votre clé d'authentification publiquement. Assurez-vous qu'elle est stockée de manière sécurisée.

📂 Endpoints

• POST /api/generate-affiche – Génère une affiche PDF et un aperçu PNG.

  Paramètres : JSON contenant les données de l'affiche (titre, sous-titre, couleurs, images, etc.). Les images (imageIA, logo) doivent être encodées en base64 et au format PNG, JPEG, GIF ou WEBP.

  Les données doivent être envoyées au format JSON. Les images (imageIA, logo) doivent être encodées en base64 (PNG, JPEG, GIF ou WEBP).

  Règles de validation :

  • template : optionnel, string, valeurs possibles : ModerneAfficheTemplate, ClassiqueAfficheTemplate, IAVisuelRondTemplate
  • format : optionnel, string, valeurs possibles : A4, A5
  • titre : requis, string, max 200 caractères
  • sousTitre : optionnel, string, max 200 caractères
  • dates : optionnel, string, max 100 caractères
  • descriptif : optionnel, string, max 1000 caractères
  • nomCommerce : optionnel, string, max 150 caractères
  • adresse : optionnel, string, max 200 caractères
  • mention : optionnel, string, max 200 caractères
  • textColor : optionnel, hexadécimal CSS (ex : #FFFFFF)
  • backgroundColor : optionnel, hexadécimal CSS
  • fontFamily : optionnel, string
  • imageIA : optionnel, base64 string (ou null)
  • logo : optionnel, base64 string (ou null)
• GET /api/fonts – Liste toutes les polices disponibles.

  Réponse : JSON contenant les familles de polices et leurs variantes.

• GET /api/templates – Liste tous les templates disponibles.

  Réponse : JSON contenant les identifiants et noms des templates.

📋 Exemples d'utilisation

GET /api/fonts

GET /api/fonts
Content-Type: application/json

Réponse :
[
  {
    "family": "Roboto Slab",
    "variants": [
      {
        "file": "RobotoSlab-400.ttf",
        "path": "resources/fonts/robotoslab/RobotoSlab-400.ttf",
        "fontFamily": "robotoslab400",
        "fontDisplay": "Roboto Slab Regular"
      },
      {
        "file": "RobotoSlab-700.ttf",
        "path": "resources/fonts/robotoslab/RobotoSlab-700.ttf",
        "fontFamily": "robotoslab700",
        "fontDisplay": "Roboto Slab Bold"
      }
    ]
  }
]
            

GET /api/templates

GET /api/templates
Content-Type: application/json

Réponse :
[
  { "id": "ClassiqueAfficheTemplate", "name": "Classique" },
  { "id": "ModerneAfficheTemplate", "name": "Moderne" },
  { "id": "IAVisuelRondTemplate", "name": "Rond (avec image IA)" }
]
            

POST /api/generate-affiche

POST /api/generate-affiche
Content-Type: application/json

{
  "template": "ModerneAfficheTemplate",
  "format": "A4",
  "titre": "Pâques en fête",
  "sousTitre": "Offres spéciales",
  "dates": "25-31 mars 2025",
  "nomCommerce": "Boulangerie du Marché",
  "descriptif": "Brioches en forme de lapin, œufs en chocolat maison...",
  "adresse": "4 rue des Artisans, 78000 Versailles",
  "mention": "Affiche générée par IA avec Liya !",
  "textColor": "#000000",
  "backgroundColor": "#FFFFFF",
  "fontFamily": "RobotoSlab-400",
  "imageIA": "data:image/png;base64,...",
  "logo": "data:image/png;base64,..."
}

Réponse :
{
  "pdf_base64": "JVBERi0xLjQKJcTl8uXrp...",
  "png_preview_base64": "iVBORw0KGgoAAAANSUhEUgAA..."
}
            

🔤 Liste des polices disponibles