Route Handlers

1
export const dynamic = 'force-dynamic' // defaults to auto
2
export async function GET(request: Request) {}

1
export async function GET() {
2
  const res = await fetch('https://data.mongodb-api.com/...', {
3
    headers: {
4
      'Content-Type': 'application/json',
5
      'API-Key': process.env.DATA_API_KEY,
6
    },
7
  })
8
  const data = await res.json()
9

10
  return Response.json({ data })
11
}

1
export async function GET(request: Request) {
2
  const { searchParams } = new URL(request.url)
3
  const id = searchParams.get('id')
4
  const res = await fetch(`https://data.mongodb-api.com/product/${id}`, {
5
    headers: {
6
      'Content-Type': 'application/json',
7
      'API-Key': process.env.DATA_API_KEY!,
8
    },
9
  })
10
  const product = await res.json()
11

12
  return Response.json({ product })
13
}

1
export async function POST() {
2
  const res = await fetch('https://data.mongodb-api.com/...', {
3
    method: 'POST',
4
    headers: {
5
      'Content-Type': 'application/json',
6
      'API-Key': process.env.DATA_API_KEY!,
7
    },
8
    body: JSON.stringify({ time: new Date().toISOString() }),
9
  })
10

11
  const data = await res.json()
12

13
  return Response.json(data)
14
}

1
export default function Page() {
2
  return <h1>Hello, Next.js!</h1>
3
}
4

5
// ❌ Conflict
6
// `app/route.js`
7
export async function POST(request) {}

1
export async function GET() {
2
  const res = await fetch('https://data.mongodb-api.com/...', {
3
    next: { revalidate: 60 }, // Revalidate every 60 seconds
4
  })
5
  const data = await res.json()
6

7
  return Response.json(data)
8
}

1
export const revalidate = 60

1
import { cookies } from 'next/headers'
2

3
export async function GET(request: Request) {
4
  const cookieStore = cookies()
5
  const token = cookieStore.get('token')
6

7
  return new Response('Hello, Next.js!', {
8
    status: 200,
9
    headers: { 'Set-Cookie': `token=${token.value}` },
10
  })
11
}

1
import { type NextRequest } from 'next/server'
2

3
export async function GET(request: NextRequest) {
4
  const token = request.cookies.get('token')
5
}

1
import { headers } from 'next/headers'
2

3
export async function GET(request: Request) {
4
  const headersList = headers()
5
  const referer = headersList.get('referer')
6

7
  return new Response('Hello, Next.js!', {
8
    status: 200,
9
    headers: { referer: referer },
10
  })
11
}

1
import { type NextRequest } from 'next/server'
2

3
export async function GET(request: NextRequest) {
4
  const requestHeaders = new Headers(request.headers)
5
}

1
import { redirect } from 'next/navigation'
2

3
export async function GET(request: Request) {
4
  redirect('https://nextjs.org/')
5
}

1
export async function GET(request: Request, { params }: { params: { slug: string } }) {
2
  const slug = params.slug // 'a', 'b', or 'c'
3
}

1
import { type NextRequest } from 'next/server'
2

3
export function GET(request: NextRequest) {
4
  const searchParams = request.nextUrl.searchParams
5
  const query = searchParams.get('query')
6
  // query is "hello" for /api/search?query=hello
7
}

1
import OpenAI from 'openai'
2
import { OpenAIStream, StreamingTextResponse } from 'ai'
3

4
const openai = new OpenAI({
5
  apiKey: process.env.OPENAI_API_KEY,
6
})
7

8
export const runtime = 'edge'
9

10
export async function POST(req: Request) {
11
  const { messages } = await req.json()
12
  const response = await openai.chat.completions.create({
13
    model: 'gpt-3.5-turbo',
14
    stream: true,
15
    messages,
16
  })
17

18
  const stream = OpenAIStream(response)
19

20
  return new StreamingTextResponse(stream)
21
}

1
// https://developer.mozilla.org/docs/Web/API/ReadableStream#convert_async_iterator_to_stream
2
function iteratorToStream(iterator: any) {
3
  return new ReadableStream({
4
    async pull(controller) {
5
      const { value, done } = await iterator.next()
6

7
      if (done) {
8
        controller.close()
9
      } else {
10
        controller.enqueue(value)
11
      }
12
    },
13
  })
14
}
15

16
function sleep(time: number) {
17
  return new Promise(resolve => {
18
    setTimeout(resolve, time)
19
  })
20
}
21

22
const encoder = new TextEncoder()
23

24
async function* makeIterator() {
25
  yield encoder.encode('<p>One</p>')
26
  await sleep(200)
27
  yield encoder.encode('<p>Two</p>')
28
  await sleep(200)
29
  yield encoder.encode('<p>Three</p>')
30
}
31

32
export async function GET() {
33
  const iterator = makeIterator()
34
  const stream = iteratorToStream(iterator)
35

36
  return new Response(stream)
37
}

1
export async function POST(request: Request) {
2
  const res = await request.json()
3
  return Response.json({ res })
4
}

1
export async function POST(request: Request) {
2
  const formData = await request.formData()
3
  const name = formData.get('name')
4
  const email = formData.get('email')
5
  return Response.json({ name, email })
6
}

1
export const dynamic = 'force-dynamic' // defaults to auto
2

3
export async function GET(request: Request) {
4
  return new Response('Hello, Next.js!', {
5
    status: 200,
6
    headers: {
7
      'Access-Control-Allow-Origin': '*',
8
      'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
9
      'Access-Control-Allow-Headers': 'Content-Type, Authorization',
10
    },
11
  })
12
}

1
export async function POST(request: Request) {
2
  try {
3
    const text = await request.text()
4
    // Process the webhook payload
5
  } catch (error) {
6
    return new Response(`Webhook error: ${error.message}`, {
7
      status: 400,
8
    })
9
  }
10

11
  return new Response('Success!', {
12
    status: 200,
13
  })
14
}

1
export const runtime = 'edge' // 'nodejs' is the default

1
export const dynamic = 'force-dynamic' // defaults to auto
2

3
export async function GET() {
4
  return new Response(
5
    `<?xml version="1.0" encoding="UTF-8" ?>
6
<rss version="2.0">
7
 
8
<channel>
9
  <title>Next.js Documentation</title>
10
  <link>https://nextjs.org/docs</link>
11
  <description>The React Framework for the Web</description>
12
</channel>
13
 
14
</rss>`,
15
    {
16
      headers: {
17
        'Content-Type': 'text/xml',
18
      },
19
    },
20
  )
21
}

1
export const dynamic = 'auto'
2
export const dynamicParams = true
3
export const revalidate = false
4
export const fetchCache = 'auto'
5
export const runtime = 'nodejs'
6
export const preferredRegion = 'auto'