Опишите контракт GET-запроса для поиска договора

Контракт GET-запроса для поиска договора обычно включает следующие элементы:

• URL: /contracts или /contracts/search

• Параметры запроса (query parameters):

  • contractId — уникальный идентификатор договора (опционально)
  • personId — идентификатор персоны, связанной с договором
  • status — статус договора (например, активный, завершённый)
  • dateFrom и dateTo — диапазон дат заключения договора
  • page и pageSize — для пагинации результатов

• Метод: GET

• Ответ:

  • Список договоров, соответствующих фильтрам, с полями:

    • contractId
    • personId
    • status
    • startDate
    • endDate
    • другие релевантные данные

• Коды ответа:

  • 200 OK — успешный поиск
  • 400 Bad Request — неверные параметры
  • 404 Not Found — договоры не найдены (опционально)

Пример запроса:

GET /contracts?personId=12345&status=active&dateFrom=2023-01-01&dateTo=2023-12-31&page=1&pageSize=20

Такой контракт обеспечивает гибкий и понятный интерфейс для поиска договоров по различным критериям.