Les modèles comme paramètres
Un modèle MostlyRender est un canevas (largeur × hauteur, arrière-plan) plus une pile de couches nommées layers. L’idée clé :
Le nom de la couche est le paramètre API. Pour modifier l’affichage d’une couche au moment du rendu, envoyez
modificationsindexées par le nom de la couche.
# Modifications
Avec un modèle contenant une couche de texte nommée title, une couche d’image nommée photo, et une
couche QR nommée link :
{
"template": "tpl_abc",
"modifications": {
"title": "Renders that never go dark",
"photo": "https://example.com/hero.jpg",
"link": "https://mostlyrender.com"
}
}
- Une chaîne sur une couche de texte définit son texte.
- Une chaîne sur une couche d’image définit son
src. - Une chaîne sur une couche QR définit la valeur encodée.
- Un objet est fusionné dans la couche, vous pouvez donc aussi surcharger le style :
{ "modifications": { "title": { "text": "On sale", "color": "#e11d48" } } }
Les couches que vous ne mentionnez pas conservent leurs valeurs par défaut conçues. Les noms de couches inconnus sont ignorés.
# Lister les modèles
curl https://api.mostlyrender.com/v1/templates \
-H "Authorization: Bearer mr_live_…"
{
"templates": [
{ "id": "tpl_abc", "name": "Launch card", "width": 1200, "height": 630, "engine": "layers" }
]
}
Utilisez l’id comme template dans un appel de rendu. Gérez les modèles (créer, modifier,
supprimer) dans l’éditeur de l’application.