1// Конвенції іменування ресурсів
2const apiRoutes = {
3  // Колекції — множина
4  "GET    /api/v1/projects":          "Список проєктів",
5  "POST   /api/v1/projects":          "Створити проєкт",
6
7  // Окремий ресурс — за ідентифікатором
8  "GET    /api/v1/projects/:id":      "Отримати проєкт",
9  "PATCH  /api/v1/projects/:id":      "Оновити проєкт",
10  "DELETE /api/v1/projects/:id":      "Видалити проєкт",
11
12  // Вкладені ресурси — належність
13  "GET    /api/v1/projects/:id/tasks": "Задачі проєкту",
14  "POST   /api/v1/projects/:id/tasks": "Створити задачу",
15
16  // Дії — для операцій, що не вписуються в CRUD
17  "POST   /api/v1/projects/:id/archive": "Архівувати проєкт",
18}

1// Успішна відповідь з пагінацією
2interface ApiResponse<T> {
3  data: T
4  meta?: {
5    page: number
6    perPage: number
7    total: number
8    totalPages: number
9  }
10}
11
12// Відповідь з помилкою
13interface ApiError {
14  error: {
15    code: string
16    message: string
17    details?: Record<string, string[]>
18  }
19}
20
21// Приклад: список проєктів
22// GET /api/v1/projects?page=1&perPage=20&status=active
23{
24  "data": [
25    {
26      "id": "proj_abc123",
27      "name": "Website Redesign",
28      "status": "active",
29      "createdAt": "2025-01-15T10:00:00Z"
30    }
31  ],
32  "meta": {
33    "page": 1,
34    "perPage": 20,
35    "total": 47,
36    "totalPages": 3
37  }
38}

1// Middleware для валідації запитів
2import { z } from "zod"
3
4const createTaskSchema = z.object({
5  title: z.string().min(1).max(200),
6  description: z.string().max(2000).optional(),
7  priority: z.enum(["low", "medium", "high", "critical"]),
8  assigneeId: z.string().uuid().optional(),
9  dueDate: z.string().datetime().optional(),
10  tags: z.array(z.string()).max(10).default([]),
11})
12
13export async function POST(request: Request) {
14  const body = await request.json()
15  const result = createTaskSchema.safeParse(body)
16
17  if (!result.success) {
18    return Response.json({
19      error: {
20        code: "VALIDATION_ERROR",
21        message: "Невалідні дані запиту",
22        details: result.error.flatten().fieldErrors,
23      },
24    }, { status: 400 })
25  }
26
27  const task = await taskService.create(result.data)
28  return Response.json({ data: task }, { status: 201 })
29}

1// Конфігурація rate limiting
2const rateLimits = {
3  // Різні ліміти для різних рівнів доступу
4  free: {
5    requests: 100,
6    window: "1h",
7    burst: 10,
8  },
9  pro: {
10    requests: 1000,
11    window: "1h",
12    burst: 50,
13  },
14  enterprise: {
15    requests: 10000,
16    window: "1h",
17    burst: 200,
18  },
19}
20
21// Заголовки відповіді з інформацією про ліміти
22// X-RateLimit-Limit: 1000
23// X-RateLimit-Remaining: 847
24// X-RateLimit-Reset: 1706000000