EventsSPb API

API для отправки отзывов и подписки на email-рассылку
Отправить отзыв
POST /api/feedback

Authentication

Open

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

Request parameters

text
string required

Текст отзыва

Example:
Мероприятие супер! Всем рекомендую

Responses

201 Created

Отзыв успешно сохранен

400 Bad Request

Ошибка валидации - отсутствует текст отзыва

Example 1
Example 2

201 Created

{
  "message": "Отзыв сохранен!",
  "text": "Мероприятие супер! Всем рекомендую"
}

400 Bad Request

{
  "error": "Текст обязателен"
}
Подписаться на email
POST /api/subscribe

Authentication

Open

Принимает email пользователя и добавляет его в список подписок на мероприятие

Request parameters

email
string email required

Адрес электронной почты

Example:
Customer1@mail.com

Responses

201 Created

Подписка оформлена!

200 OK

Вы уже подписаны

400 Bad Request

Некорректный email

Example 1
Example 2
Example 3

201 Created

{
  "message": "Подписка оформлена!",
  "email": "user@example.com"
}

200 OK

{
  "message": "Вы уже подписаны"
}

400 Bad Request

{
  "error": "Некорректный email"
}
Получить мероприятия в СПб на сегодня
GET /api/v1/events/today

Authentication

Open

Возвращает список актуальных мероприятий в Санкт-Петербурге на сегодняшний день

Responses

200 OK

Список мероприятий

500 Internal Server Error

Внутренняя ошибка сервера

Example 1
Example 2

200 ОК

[
  {
    "title": "Иммерсивная инсталляция «Пропавшие в кинохронике»",
    "place": "киностудия «Ленфильм»",
    "time": "21:30",
    "price": "от 1000 рублей",
    "age_restriction": "18+",
    "url": "https://kudago.com/spb/event/vyistavka-propavshie-v-kinohronike/"
  },
  {
    "title": "Мастер-классы по живописи «Картина за 3 часа»",
    "place": "художественная студия Artista",
    "time": "15:00",
    "price": "от 2400 до 6480 рублей",
    "age_restriction": "6+",
    "url": "https://kudago.com/spb/event/vstrecha-master-klassyi-kartina-za-3-chasa/"
  }
]

500 Internet Server Error

    [{
            "error": "Внутренняя ошибка сервера",
            "message": "Не удалось загрузить мероприятия"
        }]
Получить список креативных кластеров
GET /api/v1/clusters

Authentication

Open

Возвращает список креативных кластеров в Санкт-Петербурге

Responses

200 OK

Список кластеров

500 Internal Server Error

Внутренняя ошибка сервера

Example 1
Example 2

200 ОК

[
  {
    "id": 1,
    "name": "Артмуза",
    "address": "Кожевенная линия, 40"
  },
  {
    "id": 2,
    "name": "Ткачи",
    "address": "ул. Рубинштейна, 32"
  }
]

500 Internal Server Error

[{
            "error": "Внутренняя ошибка сервера",
            "message": "Не удалось загрузить список кластеров"
        }]
Получить список кафе в кластерах
GET /api/v1/cafes

Authentication

Open

Возвращает список кафе, расположенных в креативных кластерах

Responses

200 OK

Список кафе

500 Internal Server Error

Внутренняя ошибка сервера

Example 1
Example 2

200 ОК

[
  {
    "id": 1,
    "name": "Кофейня Loft",
    "cluster_id": 1,
    "cluster_name": "Артмуза"
  },
  {
    "id": 2,
    "name": "Бар 'Ткачи'",
    "cluster_id": 2,
    "cluster_name": "Ткачи"
  }
]

500 Internal Server Error

[{
            "error": "Внутренняя ошибка сервера",
            "message": "Не удалось загрузить список кафе"
        }]