Header, Cookies und Tokens
Ein Authorization-Header, beliebige eigene Header, Cookies und ein eigener User-Agent, sodass der Browser die Seite so lädt wie Ihre Sitzung.
Authentifizierte Aufnahme
Erfassen Sie Dashboards und Seiten hinter einem Login
Senden Sie die Header, das Token oder die Cookies, die die Seite erwartet, und erfassen Sie sie genau so, wie eine angemeldete Person sie sieht. Warten Sie, bis das Diagramm gerendert ist, blenden Sie aus, was nicht geteilt werden soll, und erhalten Sie das Bild mit einer Anfrage zurück.
Kostenloses Konto erstellenAPI-Dokumentation lesen
- Header, Cookies und Tokens
- Auf einen Selektor warten
- Beliebige Elemente ausblenden
- Ein Credit pro Aufnahme
POST /render/v1/screenshot
Authorization: Bearer if_live_...
{
"url": "https://app.example.com/reports",
"headers": {
"Authorization": "Bearer eyJhbGci..."
},
"cookies": [
{ "name": "session", "value": "..." }
],
"wait_for_selector": "#revenue-chart",
"hide_selectors": ["#support-widget"],
"full_page": true
}Eine Anfrage
Die Seite, die Sie wirklich brauchen, liegt hinter einer Sitzung
Öffentliche Seiten sind die leichte Hälfte. Die Screenshots, auf die es ankommt, sind meist das Dashboard, die Admin-Ansicht oder der Bericht, und die brauchen eine Sitzung, ein Token und ein Warten, bis das Diagramm fertig gezeichnet ist. Genau dort schreiben Teams am Ende ein Puppeteer-Skript und pflegen dann einen Browser, einen Login-Ablauf und eine Rotation der Zugangsdaten.
Ironfang Render nimmt Header, Cookies und Token als Anfrageparameter, wartet auf den Selektor, den Sie nennen, und blendet die Elemente aus, die Sie lieber nicht teilen. Die Verwaltung der Zugangsdaten bleibt in Ihrem eigenen Code, wo sie hingehört, und Sie senden das Token mit den geringsten Rechten, das die Seite lädt.
POST /render/v1/pdf
Authorization: Bearer if_live_...
{
"url": "https://app.example.com/invoice/1042",
"headers": { "Authorization": "Bearer eyJhbGci..." },
"paper_format": "a4",
"print_background": true
}Funktionen
Alles, was eine sitzungsgeschützte Seite braucht
Die Authentifizierung, das Warten und das Ausblenden, die aus einer geschützten Ansicht ein verlässliches Bild machen.
Warten auf das, was zählt
Warten Sie auf einen Selektor, der erst existiert, wenn die Ansicht gerendert ist, statt mit einer Verzögerung zu raten oder bei einem gesprächigen Dashboard auf Netzwerkruhe zu vertrauen.
Entfernen, was nicht geteilt werden soll
Blenden Sie vor der Aufnahme beliebige Selektoren aus, dazu Werbeblocker und das Ausblenden von Cookie-Bannern, sodass ein geteilter Screenshot das Support-Widget und den persönlichen Namen weglässt.
Jeder Viewport, jedes Gerät
Erfassen Sie das Desktop-Layout, ein Tablet oder ein Smartphone, mit exaktem Viewport und einem Geräteskalierungsfaktor bis 3 für ein Retina-Bild.
Ganze Seite oder ein Panel
Ganze Seite, Viewport, ein einzelnes Element per Selektor oder ein exaktes Ausschnittsrechteck, sodass ein Dashboard ein einzelnes Diagramm statt des ganzen Bildschirms liefern kann.
Kein Browser-Worker
Eine HTTPS-Anfrage an ein betriebsbereites Chromium im Vereinigten Königreich statt eines Puppeteer-Skripts und einer Sitzung, die Sie am Leben halten und rotieren müssen.
Anwendungsfälle
Wo der nützliche Screenshot ein Login braucht
Überall dort, wo die interessante Seite eine ist, für die sich Ihre Kunden oder Ihr Team anmelden müssen.
Dashboard-Zusammenfassungen
Erfassen Sie die authentifizierte Ansicht nach Zeitplan und senden Sie sie in eine E-Mail oder einen Kanal, in dem die Leute ohnehin sind.
Berichte für Kunden
Rendern Sie für einen Kunden seine eigene Ansicht eines Dashboards, ohne ihm einen Zugang zum Produkt zu geben.
Support- und Vorfallsprotokolle
Hängen Sie den Zustand einer authentifizierten Seite an ein Ticket, mit per Selektor ausgeblendeten persönlichen Daten.
Staging- und Vorschauprüfungen
Erfassen Sie eine geschützte Umgebung aus der CI mit dem Header, den sie erwartet, und hängen Sie das Bild an den Pull Request.
Archive interner Tools
Halten Sie fest, was eine Admin-Ansicht an einem Datum gezeigt hat, in einem Viewport Ihrer Wahl.
Onboarding und Dokumentation
Erzeugen Sie Produkt-Screenshots aus einem vorbereiteten Konto neu, wann immer sich die Oberfläche ändert.
Erfassen Sie auch öffentliche Seiten?
Authentifizierung ist eine Gruppe von Parametern am selben Endpunkt. Die Seite zur Screenshot-API behandelt den Rest: Formate, Viewports, Aufnahmen von Elementen und Bereichen und ganzseitige Ausgabe.
Preise
Ein Credit pro Aufnahme, zwei pro PDF
Authentifizierung ändert den Preis nicht. Starten Sie mit 250 kostenlosen Credits pro Monat, ohne Kreditkarte; bezahlte Tarife gibt es ab 9 £ pro Monat für 5.000 Credits. Cache-Treffer kosten nichts, fehlgeschlagene Aufträge werden erstattet, und beim Erreichen einer Obergrenze wird das Rendering pausiert, statt Mehrkosten zu berechnen.
Preise von Ironfang Render ansehenMit anderen Anbietern vergleichen
Fragen
Bevor Sie integrieren
Die Details, die entscheiden, ob es passt, ohne vorher die ganze Referenz zu lesen.
- Wie authentifiziere ich die Aufnahme?
- Senden Sie, was die Seite erwartet: einen Authorization-Header, eigene Header, Cookies oder einen bestimmten User-Agent. Der Browser lädt die Seite damit, sodass ein sitzungsgeschütztes Dashboard so gerendert wird wie für eine angemeldete Person.
- Mein Dashboard rendert Diagramme erst nach dem Laden. Wie erfasse ich diese?
- Warten Sie auf einen Selektor, der erst existiert, wenn das Diagramm gezeichnet ist. Das ist zuverlässiger als das Warten auf das Netzwerk, denn ein Dashboard schließt seine Anfragen oft ab, bevor es fertig gezeichnet hat.
- Kann ich eine Seite in einem privaten Netzwerk oder auf localhost erfassen?
- Nein. Render-Ziele sind gegen private, Loopback- und Link-Local-Adressen abgesichert, daher muss die Seite im öffentlichen Internet erreichbar sein. Eine Staging-Umgebung hinter Basic Auth oder einem Header funktioniert, eine hinter einem VPN nicht.
- Werden meine Zugangsdaten gespeichert?
- Header und Cookies werden für die Anfrage verwendet und sind nicht Teil des Cache-Schlüssels, den Sie zurücklesen können. Behandeln Sie sie wie jedes Geheimnis in einem API-Aufruf: Senden Sie das Token mit den geringsten Rechten, das die Seite lädt.
- Kann ich Teile der Seite vor der Aufnahme ausblenden?
- Ja. Übergeben Sie eine Liste von Selektoren zum Ausblenden und aktivieren Sie den Werbeblocker und das Ausblenden von Cookie-Bannern. Nützlich, um ein Support-Widget, einen persönlichen Namen oder ein Benachrichtigungsabzeichen aus einem geteilten Screenshot zu entfernen.
- Was ist, wenn die Seite langsam ist?
- Legen Sie ein Timeout pro Anfrage fest, fügen Sie eine feste Verzögerung von bis zu zehn Sekunden hinzu oder warten Sie auf einen bestimmten Selektor. Fehlgeschlagene Aufträge werden erstattet, sodass ein Rendering, das nie zur Ruhe kommt, nicht berechnet wird.
- Funktioniert das auch für PDFs?
- Ja. Dieselben Header, derselbe Authorization-Header und dieselben Cookies gelten für eine PDF-Anfrage, sodass ein authentifizierter Kontoauszug genau so gedruckt wird, wie er erfasst wird.
Weniger betreiben. Mehr ausliefern.
Erfassen Sie Ihre erste authentifizierte Seite
Erstellen Sie ein Konto, holen Sie sich einen Schlüssel und senden Sie den Header, den Ihre Anwendung bereits verwendet.
250 kostenlose Credits pro Monat, ohne Kreditkarte, mit festen Nutzungsobergrenzen und Erstattung bei fehlgeschlagenen Aufträgen.