Dynamic Route Handlers

app/
└── api/
    └── products/
        └── [id]/
            └── route.ts

/api/products/:id

export async function GET(
  request: Request,
  { params }: { params: Promise<{ id: string }> }
) {
  const { id } = await params;

  return Response.json({ id });
}

GET /api/products/42

{
  "id": "42"
}

type Product = {
  id: number;
  name: string;
  price: number;
};

const products: Product[] = [
  {
    id: 1,
    name: "Механічна клавіатура",
    price: 3200,
  },
  {
    id: 2,
    name: "Бездротова миша",
    price: 1800,
  },
  {
    id: 3,
    name: "USB-C хаб",
    price: 1400,
  },
];

export async function GET(
  _request: Request,
  { params }: { params: Promise<{ id: string }> }
) {
  const { id } = await params;
  const productId = Number(id);

  if (!Number.isInteger(productId) || productId <= 0) {
    return Response.json(
      { error: "Ідентифікатор товару має бути додатним цілим числом" },
      { status: 400 }
    );
  }

  const product = products.find((item) => item.id === productId);

  if (!product) {
    return Response.json(
      { error: "Товар не знайдено" },
      { status: 404 }
    );
  }

  return Response.json(product);
}

GET /api/products/2

{
  "id": 2,
  "name": "Бездротова миша",
  "price": 1800
}

GET /api/products/99

{
  "error": "Товар не знайдено"
}

GET /api/products/keyboard

{
  "error": "Ідентифікатор товару має бути додатним цілим числом"
}

app/api/users/[userId]/orders/[orderId]/route.ts

export async function GET(
  _request: Request,
  {
    params,
  }: {
    params: Promise<{
      userId: string;
      orderId: string;
    }>;
  }
) {
  const { userId, orderId } = await params;

  return Response.json({
    userId,
    orderId,
  });
}

/api/users/10/orders/25

{
  "userId": "10",
  "orderId": "25"
}

/api/products/2?currency=eur

export async function GET(
  request: Request,
  { params }: { params: Promise<{ id: string }> }
) {
  const { id } = await params;
  const url = new URL(request.url);
  const currency = url.searchParams.get("currency");

  return Response.json({
    id,
    currency,
  });
}

/api/products/2?currency=eur

{
  "id": "2",
  "currency": "eur"
}

type Product = {
  id: number;
  name: string;
  price: number;
};

const products: Product[] = [
  {
    id: 1,
    name: "Механічна клавіатура",
    price: 3200,
  },
  {
    id: 2,
    name: "Бездротова миша",
    price: 1800,
  },
];

export async function DELETE(
  _request: Request,
  { params }: { params: Promise<{ id: string }> }
) {
  const { id } = await params;
  const productId = Number(id);
  const productIndex = products.findIndex((product) => product.id === productId);

  if (productIndex === -1) {
    return Response.json(
      { error: "Товар не знайдено" },
      { status: 404 }
    );
  }

  const [deletedProduct] = products.splice(productIndex, 1);

  return Response.json({
    message: "Товар видалено",
    product: deletedProduct,
  });
}

DELETE /api/products/2

npm run dev

curl http://localhost:3000/api/products/1

curl -i http://localhost:3000/api/products/999

const { id } = await params;

const { id } = params;

app/api/products/[id]/route.ts

const { productId } = await params;

typeof id; // "string"

const productId = Number(id);

if (!Number.isInteger(productId)) {
  return Response.json(
    { error: "Некоректний ідентифікатор" },
    { status: 400 }
  );
}

return Response.json({ error: "Не знайдено" });

return Response.json(
  { error: "Не знайдено" },
  { status: 404 }
);

app/api/products/[id]/route.ts