Как в REST получить список ресурсов и один конкретный ресурс: какой URL и метод использовать?

REST строится вокруг ресурсов, у каждого из которых есть свой URL. Коллекция ресурсов и отдельный элемент коллекции — это два разных URL, но оба читаются одним и тем же методом GET, потому что чтение не изменяет состояние сервера.

URL и методы

• GET /users — вернуть список всех пользователей (коллекция).
• GET /users/42 — вернуть одного пользователя с id = 42 (элемент коллекции).
• Метод GET безопасный и идемпотентный: повторные вызовы не меняют данные.
• Для создания используют POST /users, для обновления PUT/PATCH /users/42, для удаления DELETE /users/42.

Пример на Express

const express = require('express');
const app = express();

const users = [{ id: 1, name: 'Ann' }, { id: 2, name: 'Bob' }];

// Список ресурсов
app.get('/users', (req, res) => {
  res.status(200).json(users);
});

// Один ресурс по id
app.get('/users/:id', (req, res) => {
  const user = users.find(u => u.id === Number(req.params.id));
  if (!user) return res.status(404).json({ error: 'Not found' });
  res.status(200).json(user);
});

app.listen(3000);

Коды ответов

• 200 OK — успешно, тело содержит данные.
• 404 Not Found — элемент с таким id не существует.
• 400 Bad Request — некорректный id в URL.

Такой подход применяют в любом REST API: сначала проектируют URL коллекции, затем добавляют вложенный путь с идентификатором. Это делает интерфейс предсказуемым и удобным для клиентов.

Итог: для чтения коллекции используйте GET /resources, для чтения одного элемента — GET /resources/{id}; оба метода безопасны, а различие только в URL и формате ответа.