3 Min. Lesezeit

GET oder POST für Screenshot-API-Läufe

Nutze GET für schnelle URL-Ausführungen und POST für Screenshot-API-Anfragen mit Headern, Cookies, Schritten, Labels oder Speicherzielen.

Screenshot-APIRender-API
Auf dieser Seite

Nützlich wenn

  • Nutze GET für schnelle URL-Ausgaben als Screenshot, PDF, HTML oder Markdown.
  • Nutze POST für Cookies, Header, Schritte, Dateiausgabe, Speicherziele oder längere Daten.
  • Wenn sensible Werte doch durch eine URL laufen müssen, verwende einen engen und kurzlebigen API-Schlüssel.
GET oder POST für Screenshot-API-Läufe

Wann GET reicht und wann POST besser ist

Eine Screenshot-API beginnt oft mit einer einfachen URL. Dafür bleibt GET nützlich: Zielseite, Ausgabeformat, Viewport und Cache senden, dann das Ergebnis abrufen.

POST passt, sobald der Lauf Teil eines Arbeitsablaufs wird. Header, Cookies, HTML-Eingabe, Markdown-Ausgabe, Labels, Speicherziele und Schritte bleiben im Request Body lesbarer. Sensible Werte landen nicht in Browserhistorie, Serverlogs oder geteilten URLs.

Warum das in echten Abläufen zählt

GET ist gut für ein schnelles Render-Ergebnis. POST passt, wenn dieselbe Seite erneut geprüft, gelabelt, gespeichert oder mit einer Veröffentlichung verbunden werden soll.

RenderLog hält beide Varianten in derselben Historie. Entwickler können mit einem API-Aufruf starten, und das Team kann dasselbe Ziel später in manuelle Prüfung, Prüfsuiten, Referenzen und Benachrichtigungen übernehmen.

  • CI-Jobs können einfache Render-Aufrufe kurz halten.
  • Backend-Dienste können strukturierte Requests senden, ohne jede Option in die URL zu packen.
  • Das Team bekommt nach dem API-Aufruf weiterhin Ergebnisdateien, Logs, Labels und Prüfhistorie.

Die erste Anfrageform wählen

Starte mit GET, wenn du RenderLog aus Terminal oder Browser testest. Wechsle zu POST, bevor Cookies, Autorisierungsheader, eigener Speicher oder ein Ablauf mit Wartezeiten und Selektoren dazukommen. Wenn die Seite wiederholt geprüft werden soll, speichere die Konfiguration als Prüfsuite.

So bleibt das erste Experiment klein, ohne das Team auf einen reinen Render-Endpunkt festzulegen. Dasselbe Ziel kann später zur geplanten visuellen Prüfung mit Labels, Referenzen und Benachrichtigungen werden.

Weiterführende Links

Häufige Fragen

Soll ich mit GET oder POST starten?
Starte mit GET für einen schnellen Test. Wechsle zu POST, bevor Cookies, Header, Speicherziele oder mehrstufige Abläufe dazukommen.
Ändert POST den Prüfablauf?
Nein. GET- und POST-Ausführungen landen in derselben RenderLog-Historie mit Ergebnisdateien, Labels und Prüfkontext.