hosting

POST /v1/sites/{siteId}/cache/purge

Clear a site's server-side cache.

Minden hosting végpont

Az összes fejlesztői dokumentáció

Hitelesítés

Küldjön egy API-kulcsot bearer tokenként. Ez a végpont nem határoz meg konkrét jogosultságot a specifikációban, ezért adja meg a kulcsnak a legkevesebbet, amire szüksége van, és a feltételezés helyett ellenőrizze a választ.

Ez a végpont nem fogad el szervezeti azonosítót. Az Ön kulcsa már azonosítja azt a szervezetet, amelyhez tartozik, és a válasz is erre vonatkozik.

Próbálja ki

Cserélje ki a hegyes zárójelek közötti részt a saját értékeivel, a kulcshelyőrzőt pedig a vezérlőpultján található kulccsal.

curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/cache/purge \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Be van jelentkezve? A vezérlőpultban lévő API-konzol kitölti a valós szervezetazonosítóját és a saját kulcsát, és a kérést az éles API-n futtatja, hogy láthassa a tényleges választ. Nyissa meg ezt a végpontot az API konzolban

Részletek

Drops what the hosting platform has cached for the site — everything, or one path. 202 and no body rather than 200: the platform acknowledges the purge and the edge drops the object afterwards, so claiming "done" would be a promise about a moment we never observed. The client re-reads the cache resource, whose cacheability report is stale the instant a purge lands. ⛔ Gated on sites.cache.purge, which this platform already minted for exactly this, and deliberately not on sites.panel_access: clearing a cache destroys nothing, "my change isn't showing" is the most common thing a customer or a support agent needs to do, and softer is correct here. sites.view is required alongside it, as everywhere on this surface. 404 for a site with no vendor hosting package, or one that is not the caller's; 422 when the package type does not permit a purge.

Paraméterek

NévTípusKötelezőMi ez
siteId (path)UuidIgenSite ID (UUIDv7).

Kérés törzse

NévTípusKötelezőMi ez
pathstringNemOne path to drop, relative to the site root. Omit it, or send "", to clear the whole cache.

Hibák, amelyeket ez a végpont visszaadhattatlan

401 · 403 · 404 · 422 · 429 · 503