api-endpoint
使用 Firebase 创建 Next.js API 路由。在添加 GET/POST/PATCH/DELETE 端点、实现分页、添加身份验证检查或处理文件上传时使用。包括路由模板和错误处理。
📖 中文导读:使用 Firebase 创建 Next.js API 路由。在添加 GET/POST/PATCH/DELETE 端点、实现分页、添加身份验证检查或处理文件上传时使用。包括路由模板和错误处理。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: api-endpoint description: Creates Next.js API routes with Firebase. Use when adding GET/POST/PATCH/DELETE endpoints, implementing pagination, adding auth checks, or handling file uploads. Includes route templates and error handling.
API Endpoint Skill
Instructions
- Create routes in
src/app/api/following REST conventions - Apply security layers: Rate Limiting → Auth → Validation → Business Logic
- Use
verifyAuthfor protected routes - Use
validateString,validateUrlfromsecurity-utils.ts - Return Korean error messages with proper HTTP status codes
Quick Start
import { NextRequest, NextResponse } from 'next/server'
import { verifyAuth } from '@/lib/auth-utils'
import { validateString, CONTENT_LIMITS } from '@/lib/security-utils'
import { checkRateLimit, getClientIdentifier, RATE_LIMIT_CONFIGS } from '@/lib/rate-limiter'
export async function POST(request: NextRequest) {
// 1. Rate limiting
const clientIp = getClientIdentifier(request)
const { allowed } = checkRateLimit(clientIp, RATE_LIMIT_CONFIGS.AUTHENTICATED_WRITE)
if (!allowed) return NextResponse.json({ error: '요청이 너무 많습니다.' }, { status: 429 })
// 2. Auth
const authUser = await verifyAuth(request)
if (!authUser) return NextResponse.json({ error: '인증이 필요합니다.' }, { status: 401 })
// 3. Validate & process...
}
For complete templates (dynamic routes, pagination, file upload, toggle endpoints), see reference.md.