Guia da CDN e cache de borda

Nos planos WordPress Pro e Business com a configuração opcional Cloud Offload ativada (e no plano API Momentum), as imagens otimizadas são entregues pela CDN do SmallPict (cdn.smallpict.app), presente em mais de 300 locais. Com o Cloud Offload desativado, as imagens ficam no seu servidor WordPress e são entregues a partir dele. No Free e no Starter não há CDN: as imagens otimizadas ficam no seu próprio servidor e são entregues a partir dele. Armazenamento e CDN próprios (BYO) são conectados juntos e só nos planos de API Velocity e Momentum; os planos WordPress usam a CDN do SmallPict. Os arquivos na sua própria conta de CDN ou de armazenamento ficam fora do SmallPict. O SmallPict não mantém backup dessas cópias, então faça seus próprios backups.

Arquitetura de entrega na borda

[Navegador do visitante]       │       ▼ (HTTP/3 com QUIC e TLS 1.3)[SmallPict Edge PoP (< 25ms de latência)] ───► HIT no cache (Entrega binária imediata)       │       ▼ (Cache Miss)[API do SmallPict e armazenamento em nuvem] ─────────► Transcodifica e armazena na borda

Funcionalidades essenciais da CDN

1. Roteamento Anycast global: Encaminha requisições ao ponto de presença mais próximo do visitante.
2. Protocolo HTTP/3 e compressão Brotli: Minimiza perda de pacotes e acelera transferências em conexões móveis instáveis.
3. Cabeçalhos Cache-Control imutáveis: Diretiva public, max-age=31536000, immutable para cache eficiente no navegador.
4. Purga global em < 150ms: Invalidação quase em tempo real em todos os PoPs mundiais.

Purga de cache manual via API

Invalide recursos da CDN ao atualizar uma imagem com o mesmo nome:

curl -X POST https://api.smallpict.app/v1/purge \  -H "X-API-Key: sp_live_key_9a8b7c6d5e4f3a..." \  -H "Content-Type: application/json" \  -d {    "purge_type": "url",    "urls": [      "https://cdn.smallpict.app/<customer_id>/<job_id>.avif",      "https://cdn.smallpict.app/<customer_id>/<other_job_id>.webp"    ]  }'

Você só pode fazer purge dos seus próprios arquivos: URLs em /<customer_id>/ ou seus sites WordPress com offload. "purge_type": "all" limpa todos os seus arquivos, não a CDN inteira.

Perguntas frequentes sobre a CDN

Posso usar meu próprio domínio com a CDN do SmallPict?

Não. A CDN do SmallPict sempre entrega as imagens a partir de cdn.smallpict.app; domínios personalizados não estão disponíveis. Se você precisa do seu próprio domínio, conecte sua própria CDN (Velocity ou Momentum, junto com seu próprio armazenamento) e gerencie os domínios dela na sua própria conta de CDN. Hoje, seu armazenamento pode ser Amazon S3, Cloudflare R2, Google Cloud Storage ou outro serviço compatível com S3, e sua CDN Cloudflare ou Amazon CloudFront; Azure e outras CDNs estão planejadas: veja Provedores de nuvem.

O que ocorre se o navegador do visitante não suportar AVIF?

No Pro e no Business, o Smart Next-Gen entrega AVIF com fallback WebP por meio de um elemento <picture>: navegadores sem suporte a AVIF carregam WebP, e o original no seu servidor continua sendo o último fallback. No Starter é usado um único formato (WebP ou AVIF); escolha WebP se muitos visitantes usam navegadores antigos.