Thanks to visit codestin.com
Credit goes to github.com

Skip to content

GeorgeD615/ReviewWebApi

Repository files navigation

Reviews API на ASP.NET

Описание

Этот проект представляет собой Web API, разработанный на ASP.NET Core для управления отзывами пользователей о товарах. API предоставляет возможность создавать, удалять и получать отзывы. В качестве базы данных используется Microsoft SQL Server.

Данное Web API используется в ASP.NET MVC приложении по доставке еды. Ознакомиться с ним можно здесь.

Функционал

Основные возможности API:

  • Получение отзыва по ID
  • Получение списка отзывов по ID товара
  • Создание нового отзыва
  • Удаление отзыва по ID
  • Удаление отзывов по ID пользователя

Требования

Для развёртывания проекта убедитесь, что у вас установлен и запущен docker-engine:

Установка

Шаг 1: Клонирование репозитория

git clone https://github.com/GeorgeD615/ReviewWebApi.git
cd ReviewWebApi

Шаг 2: Запуск с использованием Docker Compose

Запустите сервисы с помощью команды:

docker-compose up -d

Это развернет два контейнера:

  • mssqlserver — контейнер с SQL Server
  • reviewsapi — контейнер с вашим API

Приложение будет доступно по адресу http://localhost:5001.

Докер образ приложения размещён здесь.

Примеры использования

Получение отзывов по ID продукта

curl -X 'GET' \
  'http://localhost:5001/Review/GetByProductId?productId=3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -H 'accept: text/plain'

Пример ответа:

[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "productId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "text": "Отличный товар",
    "grade": 5,
    "date": "2024-09-19"
  }
]

Получение отзыва по ID

curl -X 'GET' \
  'http://localhost:5001/Review/GetById?id=3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -H 'accept: text/plain'

Пример ответа:

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "productId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "text": "Отличный товар",
  "grade": 5,
  "date": "2024-09-19"
}

Создание нового отзыва

curl -X 'POST' \
  'http://localhost:5001/Review/Create' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "productId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "text": "Отличный товар",
  "grade": 5
}'

Удаление отзыва по ID

curl -X 'DELETE' \
  'http://localhost:5001/Review/DeleteById?id=3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -H 'accept: */*'

Удаление отзывов по ID пользователя

curl -X 'DELETE' \
  'http://localhost:5001/Review/DeleteByUserId?userId=3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -H 'accept: */*'

Документация API

Для тестирования и просмотра документации API используется Swagger.

После запуска приложения Swagger будет доступен по адресу:

http://localhost:5001/swagger/index.html

About

ASP.NET web api

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published