Fouten

De REST API maakt gebruik van conventionele HTTP-statuscodes en een consistente JSON-foutstructuur.

# Foutstructuur

JSON-eindpunten retourneren:

json

{ "error": "templateId is required." }

(Het signed render URL-pad retourneert in plaats daarvan een korte text/plain-body, omdat het binaire gegevens bij succes retourneert.)

# Statuscodes

Status	Betekenis	Typische oorzaak
`200`	OK	Render/screenshot voltooid.
`202`	Accepted	Asynchrone taak in wachtrij — poll `GET /v1/renders/{id}`.
`400`	Bad request	Ontbrekende `template`, batch groter dan 50, of niet-toegestane screenshot-URL.
`401`	Unauthorized	Ontbrekende, ongeldige of ingetrokken API-sleutel.
`402`	Payment required	Gratis-plan quotum uitgeput — upgrade om door te gaan met renderen.
`403`	Forbidden	Ongeldige of ontbrekende handtekening op een signed render URL.
`404`	Not found	Onbekende template, taak of pad.
`405`	Method not allowed	Onjuiste HTTP-methode voor het eindpunt.
`500`	Server error	Een onverwachte fout (opnieuw proberen; neem contact op met ondersteuning als het aanhoudt).

# Quota’s

Bij het gratis abonnement worden renderingen abrupt gestopt bij uw maandelijkse limiet met 402. Betaalde abonnementen blokkeren nooit halverwege renderen — overschrijding wordt gemeten en gefactureerd (dus uw renderingen gaan nooit uit). Controleer uw huidige gebruik met GET /v1/account of de pagina Gebruik in de app.

# Foutafhandeling

python

from mostlyrender import MostlyRender, MostlyRenderError

try:
    out = mr.render("tpl_abc", modifications={"title": "Hello"})
except MostlyRenderError as e:
    print(e.status, e.body)   # e.g. 402 { "error": "…quota…" }

In een batch veroorzaken per-item-fouten niet het mislukken van het hele verzoek — elk mislukt item is een { "error": … }-vermelding in results.