Vorlagen als Parameter

Eine MostlyRender-Vorlage ist eine Leinwand (Breite × Höhe, Hintergrund) plus ein Stapel benannter Ebenen. Die Kernidee:

Der Ebenenname ist der API-Parameter. Um zu ändern, was eine Ebene zur Renderzeit anzeigt, senden Sie modifications, indiziert nach dem Ebenennamen.

# Modifikationen

Angenommen, eine Vorlage hat eine Textebene namens title, eine Bildebene namens photo und eine QR-Ebene namens link:

json

{
  "template": "tpl_abc",
  "modifications": {
    "title": "Renders that never go dark",
    "photo": "https://example.com/hero.jpg",
    "link": "https://mostlyrender.com"
  }
}

Ein String auf einer Textebene setzt ihren Text.
Ein String auf einer Bildebene setzt ihre src.
Ein String auf einer QR-Ebene setzt den codierten Wert.
Ein Objekt wird in die Ebene eingefügt, damit Sie auch das Styling überschreiben können:

json

{ "modifications": { "title": { "text": "On sale", "color": "#e11d48" } } }

Ebenen, die Sie nicht erwähnen, behalten ihre Standardwerte. Unbekannte Ebenennamen werden ignoriert.

# Vorlagen auflisten

bash

curl https://api.mostlyrender.com/v1/templates \
  -H "Authorization: Bearer mr_live_…"

json

{
  "templates": [
    { "id": "tpl_abc", "name": "Launch card", "width": 1200, "height": 630, "engine": "layers" }
  ]
}

Verwenden Sie die id als template in einem Render-Aufruf. Verwalten Sie Vorlagen (erstellen, bearbeiten, löschen) im App-Editor.