smoxy
Deutsch
Deutsch
  • Willkommen bei smoxy
  • Getting Started
    • Bildoptimierung
    • Performance
    • Security
  • Changelog
  • Account
    • Was ist ein Account?
    • Site Übersicht
      • Domain hinzufügen
    • Origins & Loadbalancer
    • Domain Übersicht
      • SSL
    • DNS Übersicht
    • Team
    • IP Lists
    • Abrechnungsdaten
  • Sites
    • Was ist eine Site?
    • Dashboard
    • Page Rules
      • Anwendungsbeispiele
    • Conditional Rules
      • Anwendungsbeispiele
      • IP Adressen und User Agents sperren
    • Bildoptimierung
    • Acceleration
    • Sicherheit
    • Grundkonfiguration
    • Redirect Sites
  • Developer Guide
    • GeoIP-Header (Request-Metadaten)
    • Cache Invalidierungs-API
    • Best Practices
      • Services Site
      • Flush Tags
      • Konfigurationsparameter testen
      • Cache Key Konfiguration für Bilder
    • Cloudflare Setup
    • Frameworks
      • Shopware 6
    • Support-Kontakt
Powered by GitBook
On this page
  • Allgemeine Informationen zu allen API Calls
  • Flush-URL
  • Flush-File
  • Flush-Tags
  • Flush-All

Was this helpful?

  1. Developer Guide

Cache Invalidierungs-API

Last updated 7 months ago

Was this helpful?

Die Cache Invalidierungs-API bietet eine Reihe Aufrufe zur Verwaltung und Aktualisierung zwischengespeicherter Inhalte, um sicherzustellen, dass Anwendungen deinen Benutzern immer die aktuellsten und relevantesten Daten liefern.

Cloudflare

Bei der Verwendung von Cloudflare muss eine zusätzliche WAF Regel erstellt werden, um sicherzustellen, dass BAN, oder PURGE Requests von Cloudflare nicht geblockt werden. Mehr Infos zur Konfiguration der WAF Regel wird im beschrieben.

Allgemeine Informationen zu allen API Calls

Als Methode für die Cacheinvalidierung können die Methoden BAN und PURGE verwendet werden und verhalten sich identisch. Die Methoden müssen abhängig des verwendeten Frameworks oder zusätzlicher Software (wie Cloudflare) gewählt werden. In der Regel kann BAN verwendet werden.

Flush-URL

Der Aufruf "Flush-URL" ermöglicht das leeren des Caches einer bestimmten URL im Cache. Egal, ob die Startseite oder eine bestimmte Ressource aktualisiert werden muss, dieser API-Aufruf stellt sicher, dass die neueste Version des Inhalts vom Ursprungsserver abgerufen wird. Die Anfrage kann wie folgt verwendet werden:

curl -X BAN -H "secret: <Token>" -H "url: /" https://www.beispiel.com/
# ODER
curl -X BAN -H "secret: <Token>" https://www.beispiel.com/url_zur_Invalidierung

Flush-File

Der Aufruf "Flush-File" ist für Fälle gedacht, in denen bestimmte Datein im Cache ungültig gemacht werden müssen. Dies ist besonders nützlich für statische Ressourcen wie HTML-, CSS- oder JavaScript-Dateien. Der Aufruf ermöglicht es, sicherzustellen, dass eine bestimmte Datei immer frisch vom Ursprungsserver abgerufen wird. Die Anfrage kann wie folgt verwendet werden:

curl -X BAN -H "secret: <Token>" -H "cache-file: 469640790ad5bda4d1cc6a19f6770214.html" https://www.beispiel.com/

Der Hash der Cache Datei wird als Antwort-Header zurückgeliefert, sollte die Option Debug-Header aktiviert sein.

Flush-Tags

Flush-Tags ist eine Funktion des Cache-Managements, mit der bestimmte Tags mit zwischengespeicherten Inhalten verknüpft werden können. Diese Tags werden mithilfe des HTTP-Headers x-cache-tags erstellt und verwaltet. Wenn Inhalte im Zusammenhang mit bestimmten Tags ungültig gemacht werden müssen, ermöglicht dieser Aufruf dies effizient. Zum Beispiel:

curl -X BAN -H "secret: <Token>" -H "tags: foo" https://www.beispiel.com/
# Tags werden über den Header "x-cache-tags: foo, bar" erstellt.

Sollen mehrere Tags gelöscht werden kann ein Request mit einer Liste an Tags übermittelt werden. Die Tags werden dabei mit Komma separiert übergeben.

curl -X BAN -H "secret: <Token>" -H "tags: foo,bar" https://www.beispiel.com/

Flush-All

In bestimmten Szenarien muss möglicherweise der gesamten Cache geleert werden. Der Aufruf "Flush-All" bietet eine Möglichkeit, alle zwischengespeicherten Inhalte zu löschen und mit den Daten des Ursprungsservers von vorne zu beginnen. Die Anfrage kann wie folgt verwenden werden:

curl -X BAN -H "secret: <Token>" -H "type: flushall" https://www.beispiel.com/

Anwendungsfälle und Ideen zur Verwendung von Flush-Tags können in den nachgelesen werden.

Cloudflare Setup
Best Practices