Si funksionon rivalidimi në kërkesë (ISR)?

Question

Accepted Answer

**Rivalidimi në kërkesë** ju lejon të **çaktivizoni faqet e memoruara/statike saktësisht kur të ndryshojnë të dhënat** — në vend që të prisni për një interval bazuar në kohë. Ito është komplementi i saktë për ISR-in bazuar në kohë (`revalidate: N`).

## Bazuar në kohë vs në kërkesë

```tsx
// Time-based: page refreshes on a fixed schedule (may serve stale data up to N seconds)
export const revalidate = 3600; // every hour

// On-demand: refresh the INSTANT the underlying data changes — no waiting, no waste
```

ISR-i bazuar në kohë është i thjeshtë por jo i përsosur: shumë i shkurtër = rigjenerim i panevojshëm; shumë i gjatë = përmbajtje e vjetër. Rivalidimi në kërkesë e zgjidh këtë duke shkaktuar rivalidimin nga kodi juaj kur një ndryshim vërtet ndodh.

## Dy API-t në kërkesë

```tsx
import { revalidatePath, revalidateTag } from "next/cache";

// 1. Tag your fetches, then invalidate by tag
await fetch("https://api/posts", { next: { tags: ["posts"] } });
revalidateTag("posts");      // refresh EVERY page/fetch tagged "posts"

// 2. Or invalidate a specific path
revalidatePath("/blog/my-post");
```

## Një punë e vërtetë: webhook i CMS-it

```ts
// app/api/revalidate/route.ts — called by your CMS when an editor publishes
import { revalidateTag } from "next/cache";
import { NextRequest, NextResponse } from "next/server";

export async function POST(req: NextRequest) {
  const secret = req.nextUrl.searchParams.get("secret");
  if (secret !== process.env.REVALIDATE_SECRET) {       // verify it's really your CMS
    return NextResponse.json({ ok: false }, { status: 401 });
  }
  revalidateTag("posts");                                // rebuild affected pages now
  return NextResponse.json({ revalidated: true });
}
```

Rrjedha: redaktori publikon në CMS → CMS thërret webhook-un tuaj → `revalidateTag("posts")` çaktivizo cache-in → vizitorit i ardhshëm i jepet HTML-i statik i rigjeneruar. Faqet qëndrojnë statike-të shpejta **dhe** përditësohen menjëherë gjatë botimit.

## Pas ndryshimit të Server Action

```tsx
"use server";
export async function createPost(data) {
  await db.post.create({ data });
  revalidateTag("posts"); // user sees their new post immediately
}
```

## Pse është e rëndësishme

Rivalidimi në kërkesë ju jep Shen të shenjtë: **performancë statike me fresknësi në kohë reale**.

Në vend të hamendjes së një intervali rivalidimi, ju çaktivizoni saktësisht kur përmbajtja ndryshon — përmes webhook-ave (botim CMS-i) ose pas mutacioneve të Server Action — duke përdorur `revalidateTag`/`revalidatePath`.

Eliminoj si përmbajtjen e vjetër ashtu edhe rigjenerimin e dëmshëm të jashtëzakonshëm, duke e bërë ISR praktike për përmbajtjen që përditësohet në mënyrë të paparashikueshme.