Skip to main content

Де створюються API Routes?

API Routes у Next.js створюються всередині проєкту, і конкретне місце залежить від того, який роутер використовується.


Pages Router

Якщо використовується Pages Router, API Routes створюються в теці:

/pages/api

Як це працює:

  • кожен файл - окремий API-ендпоінт
  • ім'я файлу стає частиною URL

Приклад:

/pages/api/users.ts → /api/users /pages/api/posts.ts → /api/posts

App Router (Route Handlers)

В App Router API Routes створюються в теці:

/app/api

Всередині використовується файл:

route.ts (або route.js)

Приклад структури:

/app/api/posts/route.ts → /api/posts /app/api/users/[id]/route.ts → /api/users/123

Головна відмінність підходів

  • Pages Router:
    • простіший і старіший
    • працює тільки через /pages/api
  • App Router:
    • сучасний підхід
    • краще інтегрований з Server Components
    • підтримує HTTP-методи (GET, POST, PUT, DELETE тощо)

Де виконується код API Routes

Незалежно від підходу:

  • API Routes завжди виконуються на сервері
  • не потрапляють у клієнтський JavaScript
  • можуть безпечно працювати з БД і секретами

Коротке резюме

  • У Pages Router API Routes знаходяться в /pages/api
  • У App Router API Routes знаходяться в /app/api/**/route.ts
  • Кожен файл - окремий API-ендпоінт
  • Весь код API Routes виконується тільки на сервері

Коротка відповідь

Для співбесіди
Premium

Коротка відповідь допоможе вам впевнено відповідати на цю тему під час співбесіди.