Building API Routes in Next.js
Next.js allows you to create API endpoints directly within your application using API Routes.
What are API Routes?
API Routes let you build your backend API inside your Next.js app. Any file inside pages/api/ becomes an API endpoint instead of a page.
Creating Your First API Route
Create a file at pages/api/hello.js:
export default function handler(req, res) {
res.status(200).json({ message: 'Hello from Next.js!' });
}
This creates an endpoint at /api/hello that returns JSON.
Handling Different HTTP Methods
export default function handler(req, res) {
if (req.method === 'POST') {
// Handle POST request
const data = req.body;
res.status(201).json({ created: data });
} else if (req.method === 'GET') {
// Handle GET request
res.status(200).json({ items: [] });
} else {
res.status(405).end(); // Method Not Allowed
}
}
Use Cases
- Form submissions
- Database queries
- Authentication
- Third-party API proxying
API Routes are perfect for building full-stack applications with Next.js!
