Purge cache by Tags

Elimina in modo efficiente uno o più file dalla cache di iSmartFrame specificando i tag.

POST https://app.ismartframe.com/api/v1/cache/purge/tag

nota

Se utilizzi la funzionalità "Cache per Paese" sul tuo sito web, sarà necessario includere il codice del Paese come parametro aggiuntivo nel corpo della richiesta.

Headers

Nome	Tipo	Descrizione
Authorization	String	Bearer YOUR_API_KEY, con la tua API Key

avviso

La chiave nell'URL (?api_key=) funziona solo fino al 30 giugno 2027. Come passare all'header

Request Body

Nome	Tipo	Descrizione
tag	Array of strings	Elenco dei tag di cui svuotare la cache.
country	String	ISO 3166-1 alpha-2 Codice Paese

cURL

curl --location 'https://app.ismartframe.com/api/v1/cache/purge/tag' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "tag": [
        "tag1", 
        "tag2" 
    ]
}'

Node.js

const axios = require('axios');

let data = JSON.stringify({
  "tag": [
    "tag1",
    "tag2"
  ]
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://app.ismartframe.com/api/v1/cache/purge/tag',
  headers: { 
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Come funziona?

La nostra piattaforma ti consente di associare uno o più tag a una risorsa memorizzata nella cache del tuo sito web tramite tre opzioni, utilizzabili anche insieme.

Tag per intestazione

È possibile configurare un'intestazione di risposta designata (per impostazione predefinita Cache-Tag) che verrà inviata dal backend del tuo sito web ogni volta che la piattaforma avvia una richiesta. L'intestazione della cache deve comprendere uno o più tag, separati da virgole. Valori di esempio: tag1, tag2, tag3.

nota

Questa opzione si rivela preziosa soprattutto quando è necessario eseguire una pulizia della cache per tutte le pagine che contengono un particolare articolo (ricerche, inserzioni, ecc.) sul tuo sito web di notizie o un prezzo di prodotto specifico (inserzioni, pagine prodotto, ecc.) sul tuo sito di e-commerce. È essenziale assicurarsi che il tuo backend supporti questa funzionalità incorporando i tag appropriati nell'intestazione personalizzata e implementando una logica corretta; in caso contrario, questa funzionalità potrebbe non funzionare come previsto.

Tag per modello

Se preferisci non implementare un'intestazione di risposta tag personalizzata (o non ne hai bisogno), puoi in alternativa assegnare uno o più tag a uno specifico pattern URL (o a un URL preciso). Ciò consente di taggare tutti gli URL che corrispondono al pattern designato, facilitando la pulizia della cache per tag sulle risorse identificate.

Tag per cartella

Se attivi nella pagina Cache del sito l'opzione che genera i tag dal percorso dell'URL, ogni pagina riceve un tag per ciascuna cartella del suo percorso, fino a 4 livelli. I tag iniziano con folder- e le cartelle sono separate da -f-.

Esempio: /folderA/folderB/folderC/page.html genera 3 tag:

• folder-folderA
• folder-folderA-f-folderB
• folder-folderA-f-folderB-f-folderC

Svuotando il tag folder-folderA-f-folderB elimini dalla cache tutte le pagine sotto /folderA/folderB/, come in una pulizia per cartella. Le pagine nella radice del sito (ad esempio /page.html) non ricevono tag di cartella.

In tutti i casi, l'intestazione di risposta "Isf-Tags" verrà impostata dai nostri sistemi per mostrare i tag associati alla risorsa memorizzata nella cache. Ciò garantisce che, al momento del recupero, l'intestazione si presenti in modo coerente, offrendo preziose informazioni sui tag strettamente collegati alla risorsa memorizzata nella cache.