Fehler

Die REST API verwendet herkömmliche HTTP-Statuscodes und eine konsistente JSON-Fehlerform.

# Fehlerform

JSON-Endpunkte geben zurück:

json

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

(Der Pfad signed render URL gibt stattdessen einen kurzen text/plain-Body zurück, da er bei Erfolg Binärdaten bereitstellt.)

# Statuscodes

Status	Bedeutung	Typische Ursache
`200`	OK	Render/Screenshot abgeschlossen.
`202`	Accepted	Asynchroner Auftrag in Warteschlange — Abfrage `GET /v1/renders/{id}`.
`400`	Bad request	Fehlende `template`, Batch über 50 oder unerlaubte Screenshot-URL.
`401`	Unauthorized	Fehlender, ungültiger oder widerrufener API-Schlüssel.
`402`	Payment required	Kostenlose Plan-Quote erschöpft — aktualisieren Sie, um weiterhin zu rendern.
`403`	Forbidden	Ungültige oder fehlende Signatur auf einer signierten Render-URL.
`404`	Not found	Unbekannte Vorlage, Auftrag oder Pfad.
`405`	Method not allowed	Falsche HTTP-Methode für den Endpunkt.
`500`	Server error	Ein unerwarteter Fehler (erneut versuchen; Support kontaktieren, wenn das Problem bestehen bleibt).

# Quoten

Im free-Plan werden Renderungen bei Ihrer monatlichen Obergrenze mit 402 hart gestoppt. Paid-Pläne blockieren niemals während des Renderings — Überschuss wird gemessen und in Rechnung gestellt (daher werden Ihre Renderungen niemals unterbrochen). Überprüfen Sie Ihre aktuelle Nutzung mit GET /v1/account oder der Seite Usage in der App.

# Fehlerbehandlung

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 einem batch führen einzelne Fehler nicht zum Fehlschlag der gesamten Anfrage — jedes fehlgeschlagene Element ist ein { "error": … }-Eintrag in results.