Renders

POST /v1/renders rendert één template naar een afbeelding of PDF.

# Verzoek

bash

curl https://api.mostlyrender.com/v1/renders \
  -H "Authorization: Bearer mr_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "tpl_abc",
    "modifications": { "title": "Hello" },
    "output": "png"
  }'

Veld	Type	Opmerkingen
`template`	string	Verplicht. De template-id. (`templateId` wordt ook geaccepteerd.)
`modifications`	object	Layer-overschrijvingen, gecodeerd op laagnaam. Zie Templates als parameters.
`output`	string	`png` (standaard), `jpeg`, `webp`, of `pdf`.
`async`	boolean	Zet de taak in de wachtrij en geef `202` terug in plaats van inline te renderen.
`webhookUrl`	string	Ondertekende callback bij voltooiing (impliceert `async`). Zie Async & webhooks.
`notifyEmail`	string	E-mail dit adres wanneer de taak is voltooid (impliceert `async`).

# Antwoord

json

{
  "id": "rnd_abc123",
  "url": "https://img.mostlyrender.com/mostlyrender/renders/rnd_abc123.png",
  "output": "png"
}

De url is openbaar en in CDN-cache opgeslagen. Renders worden ook geregistreerd in de app onder Gebruik.

# Uitvoerformaten

png — lossless, transparantie. De standaard.
jpeg / webp — kleiner; goed voor foto’s.
pdf — vector, geweldig voor printklare assets.

# SDK

python

out = mr.render("tpl_abc", modifications={"title": "Hello"}, output="pdf")
print(out["url"])

Voor veel afbeeldingen in één aanroep, zie Batch. Voor <img>/OG-inleding zonder een API-sleutel, zie Ondertekende render-URL’s.