4.1 API 开发基础

✅ 好的设计：
GET    /api/posts           - 获取所有文章
GET    /api/posts/1         - 获取 ID 为 1 的文章
POST   /api/posts           - 创建新文章
PUT    /api/posts/1         - 更新文章
DELETE /api/posts/1         - 删除文章

❌ 不好的设计：
GET    /api/getPosts
GET    /api/getPostById?id=1
POST   /api/createPost

// app/api/hello/route.ts
import { NextResponse } from 'next/server';
 
export async function GET() {
  return NextResponse.json({
    message: "Hello from API!",
    timestamp: new Date().toISOString()
  });
}

{
  "message": "Hello from API!",
  "timestamp": "2025-10-30T10:30:00.000Z"
}

// app/api/posts/[id]/route.ts
import { NextResponse } from 'next/server';
 
export async function GET(
  request: Request,
  { params }: { params: { id: string } }
) {
  const id = params.id;
 
  // 模拟从数据库获取数据
  const post = {
    id,
    title: `文章 ${id}`,
    content: "这是文章内容",
    author: "Ben"
  };
 
  return NextResponse.json(post);
}

// app/api/contact/route.ts
import { NextResponse } from 'next/server';
 
export async function POST(request: Request) {
  const body = await request.json();
 
  const { name, email, message } = body;
 
  // 验证数据
  if (!name || !email || !message) {
    return NextResponse.json(
      { error: "缺少必要字段" },
      { status: 400 }
    );
  }
 
  // 这里可以保存到数据库或发送邮件
  console.log("收到联系表单:", { name, email, message });
 
  return NextResponse.json({
    success: true,
    message: "感谢您的留言！"
  });
}

帮我在 Next.js 项目中创建一个 API，功能是：

接口路径：/api/subscribe
请求方法：POST
接收参数：
- email (必填)
- name (可选)

功能：
1. 验证邮箱格式
2. 检查邮箱是否已存在
3. 保存到数据库（暂时可以打印到控制台）
4. 返回成功或失败信息

请创建完整的代码，包含错误处理。