CDN Rendering API
In diesem Artikel wird erklärt, wie die creoline® CDN Rendering API angesteuert werden kann. Die hier angegebenen Parameter werden über die HTTP Query Parameter zur Laufzeit konfiguriert.
Voraussetzungen
Damit die Rendering API genutzt werden kann, muss diese zunächst über unser Kundencenter aktiviert werden. Melden Sie sich hierzu in unserem Kundencenter unter account.creoline.com an und wählen Sie die gewünschte CDN-Ressource aus, für die die Rendering API aktiviert werden soll. Öffnen Sie anschließend die Einstellungen über die Registerkarte Einstellungen und aktivieren Sie dort die Rendering API.
Die Bildmanipulation kann nur bei Quell-Ressourcen bis zu 10 MiB und Bildgrößen bis zu 4.000 x 4.000 Pixel verwendet werden. Ist die Quell-Datei auf Ihrem Ziel-Server größer als 10 MB oder überschreitet die Maße von 4.000 x 4.000 Pixel, wird die Originaldatei zurückgeliefert.
Parameter-Übersicht
| Parameter | Standard-Wert | Beschreibung |
|---|---|---|
| w | NULL | Bildbreite |
| h | NULL | Bildhöhe |
| ar | 1 | Seitenverhältnis-Berücksichtigung |
| q | NULL | Bildqualität (JPG, PNG, WebP) |
| webp | 1 | WebP-Grafik automatisch erzeugen |
| avif | 1 | AVIF-Grafik automatisch erzeugen |
| c | default | Mögliche Werte: default (Standard), gray (Graustufen) |
Automatische WebP-Konvertierung deaktivieren
Mithilfe des Parameters webp können Sie die automatische Konvertierung von WebP-Grafiken deaktivieren.
# Originalbild
https://assets.cstatic.io/img/cdn/example-resize.jpg
# JPG-Grafik wird nicht automatisch zu WebP konvertiert:
https://assets.cstatic.io/img/cdn/example-resize.jpg?webp=0Manipulation der Bildgröße
Die Manipulation der Bildgröße kann über die Parameter w Width (Breite) und h Height (Höhe) definiert werden. Die Manipulation der Bildgröße eignet sich z.B. für das Generieren von Thumbnails auf Vorschauseiten ohne zusätzliche Thumbnails generieren zu müssen.
# Originalbild
https://assets.cstatic.io/img/cdn/example-resize.jpg
# Bildgröße reduziert auf: 250x250
https://assets.cstatic.io/img/cdn/example-resize.jpg?w=250
In diesem Beispiel wird das Bild auf die Größe von 250px * 250px gerendert, wobei die Größenanpassung in der Standardeinstellung das Seitenverhältnis berücksichtigt.
Durch den Paramter ar Aspect-Ratio (Seitenverhältnis) können Bilder unabhängig von dem tatsächlichen Seitenverhältnis generiert werden.
Achtung: Durch das Deaktivieren der Seitenverhältnis-Berücksichtigung können Grafiken ungewollt manipuliert werden.
Beispiel:
# Originalbild
https://assets.cstatic.io/img/cdn/example-resize.jpg
# Bildgröße reduziert auf: 250x350
https://assets.cstatic.io/img/cdn/example-resize.jpg?w=250&h=350&ar=0Manipulation der Bildqualität
Über den HTTP Query Parameter q kann die Qualität des Bildes unabhängig von der CDN Einstellung beeinflusst werden. Je nach Bildtyp gibt es verschiedene Parameter.
Bildqualität für JPG-, AVIF- und WebP-Grafiken:
| Parameter | Wert | Qualität |
|---|---|---|
| q | 20 | Gering |
| q | 40 | Mittel |
| q | 60 | Gut |
| q | 80 | Sehr gut (empfohlen) |
| q | 100 | Original |
Bildkompression für PNG-Grafiken:
| Parameter | Wert | Qualität |
|---|---|---|
| q | 6 | Mittel |
| q | 7 | Gut |
| q | 8 | Sehr gut |
| q | 9 | Maximal (empfohlen) |
In den Einstellungen Ihrer CDN-Ressource können die Einstellungen pro Bildtyp global definiert werden, sodass die Angabe der Qualität in der URL nicht benötigt wird. Hierzu können Sie im Kundencenter unter CDN → Einstellungen die Qualität der Bildtypen definieren.