Référence API

curl https://mailbuildr.com/api/compile-blocks \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"blocks": [...]}'

{
  "id": "string",              // UUID généré si absent
  "type": "container | text | image | button | divider | spacer | social | video | blockquote | rawhtml | timer",
  "style": { ... },            // Objet de style (voir ci-dessous)
  "children": [ ... ]          // Blocs enfants (container uniquement)
}

curl -X POST https://mailbuildr.com/api/blocks/create \
  -H "x-api-key: sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Email de confirmation de commande avec numéro, récapitulatif produit, et CTA de suivi."}'

const API_KEY = process.env.MAILBUILDR_API_KEY;
const BASE = 'https://mailbuildr.com';

async function generateAndCompile(prompt) {
  // 1. Génère l'arbre de blocs avec l'IA
  const genRes = await fetch(`${BASE}/api/blocks/create`, {
    method: 'POST',
    headers: {
      'x-api-key': API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ prompt }),
  });

  if (!genRes.ok) {
    const err = await genRes.json();
    throw new Error(`Génération échouée: ${err.error}`);
  }

  const { blocks } = await genRes.json();

  // 2. Compile l'arbre en HTML email-safe
  const compileRes = await fetch(`${BASE}/api/compile-blocks`, {
    method: 'POST',
    headers: {
      'x-api-key': API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ blocks }),
  });

  const { html } = await compileRes.json();
  return html;
}

// Utilisation
const html = await generateAndCompile(
  'Email newsletter hebdo pour une startup FinTech, section actualités et CTA.'
);
console.log(`HTML généré: ${html.length} caractères`);

import os, requests

API_KEY = os.environ['MAILBUILDR_API_KEY']
BASE = 'https://mailbuildr.com'
HEADERS = {'x-api-key': API_KEY, 'Content-Type': 'application/json'}

def modify_blocks(blocks, instruction):
    r = requests.post(
        f'{BASE}/api/blocks/modify',
        headers=HEADERS,
        json={'blocks': blocks, 'instruction': instruction}
    )
    r.raise_for_status()
    return r.json()['blocks']

# Charger des blocs existants (ex: depuis votre BDD)
with open('email_template.json') as f:
    blocks = json.load(f)

# Modifier le CTA
updated = modify_blocks(blocks, 'Change le bouton en vert et le texte en "Voir l\'offre"')
print(f'Blocs modifiés: {len(updated)}')