On-demand revalidation (ISR) कसे काम करते?

Question

Accepted Answer

**On-demand revalidation** तुम्हाला cached/static पृष्ठ **अचूकपणे तेव्हा अमान्य करण्याची परवानगी देते जेव्हा डेटा बदलतो** — वेळ-आधारित मध्यांतरासाठी प्रतीक्षा करण्याऐवजी. हे वेळ-आधारित ISR (`revalidate: N`) च्या अचूक पूरक आहे.

## वेळ-आधारित विरुद्ध on-demand

```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 साधा आहे परंतु अपूर्ण: खूप कमी = अनावश्यक पुनर्निर्मिती; खूप लांब = जुनी सामग्री. On-demand हे तुमच्या कोडमधून revalidation ट्रिगर करून सुधारते जेव्हा वास्तविक बदल होतो.

## दोन on-demand API

```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");
```

## वास्तविक वर्कफ्लो: CMS webhook

```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 });
}
```

प्रवाह: संपादक CMS मध्ये प्रकाशित करतो → CMS तुमचा webhook कॉल करतो → `revalidateTag("posts")` cache अमान्य करतो → पुढील अतिथी ताज्या पुनर्निर्मीत static HTML मिळवतो. पृष्ठ static-वेगवान **आणि** प्रकाशनाच्या क्षणी तयार अद्यतन राहतात.

## Server Action उत्परिवर्तनानंतर

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

## हे महत्वाचे का आहे

On-demand revalidation तुम्हाला पवित्र कंघाळ देतो: **real-time ताजेपणासह static कार्यक्षमता**.

Revalidation मध्यांतरचे अनुमान लावण्याऐवजी, तुम्ही अचूकपणे अमान्य करता जेव्हा सामग्री बदलते — webhooks (CMS प्रकाशन) किंवा Server Action उत्परिवर्तनानंतर — `revalidateTag`/`revalidatePath` वापरून.

हे जुनी सामग्री आणि व्यर्थ अत्यधिक-पुनर्निर्मिती दोन्ही दूर करते, ISR ला अप्रत्याशितपणे अपडेट होणाऱ्या सामग्रीसाठी व्यावहारिक बनवते.