/
Заведения

Заведения

Получение списка заведений

Описание: Позволяет получить информацию по всем заведениям ТСП

Адрес: https://api.cloudtips.ru/api/places

Тип: GET

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

createdDateFrom

String

Нет

Поиск по дате создания с

createdDateTo

String

Нет

Поиск по дате создания по

name

String

Нет

Поиск по названию (есть поддержка поиска частичному названию)

administratorId

Array of string

Нет

Поиск по администраторам

ids

Array of string

Нет

Поиск по уникальному идентификатору заведения

externalPlaceId

String

Нет

Внешний идентификатор заведения

page

Integer

Нет

Номер страницы паджинации

limit

Integer

Нет

Ограничение на количество записей

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

{ "createdDateFrom": "string", "createdDateTo": "string", "name": "string", "administratorId": [ "string" ], "ids": [ "string" ], "externalPlaceId": "string", "page": "integer", "limit": "integer" }

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

id

String

Да

Уникальный идентификатор заведения

externalPlaceId

String

Да

Внешний идентификатор заведения

createdDate

String

Да

Дата создания

updatedDate

String

Да

Дата обновления

name

String

Да

Имя заведения

placeType

Integer

Да

Тип заведения

managerId

String

Да

Уникальный идентификатор менеджера

placeAdministratorId

Array of string

Да

Администраторы заведения

company

 

Нет

Компания

company.id

String

Да

Уникальный идентификатор компании

company.name

String

Да

Название компании

employeeCount

Integer

Да

Количество сотрудников в заведении

hasPaymentPageSettings

Boolean

Да

Включена страница оплаты для заведения, значения true и false

rating

 

Да

Рейтинг

enabled

Boolean

Да

Включен, значения true и false

components

 

Да

Компоненты рейтинга

id

String

Да

Уникальный идентификатор компонента

title

String

Да

Название компонента

imageId

String

Да

Уникальный идентификатор картинки

imageUrl

String

Да

URL картинки

averageScore

Integer

Да

Средний рейтинг

scoreCount

Integer

Да

Количество оценок

totalCount

Integer

Да

Количество записей

succeed

String

Да

Стату запроса

errors

Array of string

Да

Возвращатеся список ошибок, относящихся целиком к запросу

validationErrors

Array of string

Да

Поле представлено в формате ключ-значение и содержит ошибки, которые отнести к конкретному полю запроса

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

{ "data": { "items": [ { "id": "string", "externalPlaceId": "string", "createdDate": "2021-05-31T12:09:54.104Z", "updatedDate": "2021-05-31T12:09:54.104Z", "name": "string", "placeType": 0, "managerId": "string", "placeAdministratorIds": [ "string" ], "company": { "id": "string", "name": "string" }, "employeeCount": 0, "hasPaymentPageSettings": true, "rating": { "enabled": true, "components": [ { "id": "string", "title": "string", "imageId": "string", "imageUrl": "string" } ], "averageScore": 0, "scoreCount": 0 } } ], "totalCount": 0 }, "succeed": true, "errors": [ "string" ], "validationErrors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] } }

Получение информации по заведению

Описание: Получить информацию по одному заведению

Адрес: https://api.cloudtips.ru/api/places/{id}

Тип: GET

Запрос:

-

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

-

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

id

String

Да

Уникальный идентификатор заведения

externalPlaceId

String

Да

Внешний идентификатор заведения

createdDate

String

Да

Дата создания

updatedDate

String

Да

Дата обновления

name

String

Да

Поиск по названию

placeType

Integer

Да

Тип завдениея, значения:

 

managerId

String

Да

Уникальный идентификатор менеджера

placeAdministrators

 

Да

Администраторы заведения

userId

String

Да

Уникальный идентификатор администратора

name

String

Да

Имя администратора

company

 

Нет

Компания

id

String

Да

Уникальный идентификатор компании

name

String

Да

Название компании

employeeCount

Integer

Да

Количество сотрудников в заведении

hasPaymentPageSettings

Boolean

Да

Включена страница оплаты для заведения, значения true и false

rating

 

Да

Рейтинг

enabled

Boolean

Да

Включен, значения true и false

components

 

Да

Компоненты рейтинга

id

String

Да

Уникальный идентификатор компонента

title

String

Да

Название компонента

imageId

String

Да

Уникальный идентификатор картинки

imageUrl

String

Да

URL картинки

averageScore

Integer

Да

Средний рейтинг

scoreCount

Integer

Да

Количество оценок

succeed

String

Да

Стату запроса

errors

Array of string

Да

Возвращатеся список ошибок, относящихся целиком к запросу

validationErrors

Array of string

Да

Поле представлено в формате ключ-значение и содержит ошибки, которые отнести к конкретному полю запроса

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

{ "data": { "id": "string", "createdDate": "2021-06-01T09:50:26.271Z", "updatedDate": "2021-06-01T09:50:26.271Z", "name": "string", "externalPlaceId": "string", "leadId": "string", "webSite": "string", "comment": "string", "placeType": 0, "managerId": "string", "placeCode": "string", "placeAdministrators": [ { "userId": "string", "name": "string" } ], "employeesPage": { "disabled": true, "url": "string", "qrLink": "string", "backgroundUrl": "string", "disabledEmployees": [ { "userId": "string", "disabledDate": "2021-06-01T09:50:26.271Z" } ] }, "rating": { "enabled": true, "components": [ { "id": "string", "title": "string", "imageId": "string", "imageUrl": "string" } ], "averageScore": 0, "scoreCount": 0 }, "company": { "id": "string", "name": "string" }, "payerFee": { "enabled": true, "buttonPosition": "string" }, "addressInfo": { "country": "string", "city": "string", "address": "string", "latitude": 0, "longitude": 0 }, "employeesCount": 0 }, "succeed": true, "errors": [ "string" ], "validationErrors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] } }

Создание заведения

Описание: Создание заведения

Адрес: https://api.cloudtips.ru/api/places

Тип: POST

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

name

String

Да

Поиск по названию

externalInfo.id

String

Нет

Внешний идентификатор заведения

placeType

Integer

Нет

Тип заведения

placeAdministratorId

Array of string

Нет

Администраторы заведения

employeesPage

 

Нет

Страница оплаты заведения

routeId

String

Нет

Уникальный идентификатор для URL

backgroundUrl

String

Нет

Картинка для страницы оплаты заведения

companyId

String

Нет

Идентификатор компании

webSite

String

Нет

Адрес сайта

comment

String

Нет

Внутренний комментарий

addressInfo

String

Нет

Геоданные заведения

country

String

Нет

Страна

city

String

Нет

Город

address

String

Нет

Улица

latitude

Integer

Нет

Широта

longitude

Integer

Нет

Долгота

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

{ "name": "string", "externalInfo": { "id": "string" }, "placeType": 0, "managerId": "string", "placeAdministratorIds": [ "string" ], "employeesPage": { "routeId": "string", "backgroundUrl": "string" }, "companyId": "string", "webSite": "string", "comment": "string", "addressInfo": { "country": "string", "city": "string", "address": "string", "latitude": 0, "longitude": 0 } }

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

id

String

Да

Уникальный идентификатор заведения

succeed

String

Да

Стату запроса

errors

Array of string

Да

Возвращатеся список ошибок, относящихся целиком к запросу

validationErrors

Array of string

Да

Поле представлено в формате ключ-значение и содержит ошибки, которые отнести к конкретному полю запроса

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

{ "data": { "id": "string" }, "succeed": true, "errors": [ "string" ], "validationErrors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] } }

Возможные ошибки

  • Не указано имя заведения (параметр name):

{ "succeed": false, "errors": [], "validationErrors": { "Name": [ "Необходимо указать название заведения" ] } }
  • Имя заведения существует

{ "succeed": false, "errors": ["Заведение с названием "{имя заведения из запроса}" уже существует"], "validationErrors": {} }

Создание управляющего заведения

Описание: создание управляющего для заведения

Адрес: https://api.cloudtips.ru/api/place-administrators

Тип: POST

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

email

String

Да

Email управляющего

phoneNumber

String

Нет

Номер телефона управляющего

name

String

Да

Имя управляющего

managerId

String

Нет

Уникальный идентификатор менеджера

placeIds

Array of string

Нет

Уникальные идентификаторы заведений

permissions

Integer(int32)

Нет

Разрешения применяемые к управляющему

Доступные значения(enum):

  • Создание заведения - 1

  • Редактирование заведения - 2

  • Создание получателя - 4

  • Редактирование получателя - 8

  • Привязка получателя - 16

  • Отвязка получателя - 32

  • Создание управляющего - 64

  • Редактирование страницы сотрудников - 128

  • Редактирование платежной страницы заведения - 256

  • Редактирование настроек рейтинга заведения - 512

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

{ "email": "user@example.com", "phoneNumber": "string", "name": "string", "managerId": "string", "placeIds": [ "string" ], "permissions": 1 }

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

succeed

Boolean

Нет

Стату запроса

errors

Array of string

Нет

Возвращатеся список ошибок, относящихся целиком к запросу

validationErrors

Array of string

Нет

Поле представлено в формате ключ-значение и содержит ошибки, которые отнести к конкретному полю запроса

data

Array of string

Нет

 

id

 

Нет

Уникальный идентификатор управляющего

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

{ "succeed": true, "statusCode": 0, "errors": [ "string" ], "validationErrors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "data": { "id": "string" } }

 

Включение страницы со списком всех сотрудников заведения

Описание: Позволяет включить страницу со списком всех сотрудников заведения. Для включения необходимо:

  1. Сделать запрос GET https://api.cloudtips.ru/api/places/{placeId}/payment-pages/urls/generate, передав уникальный идентификатор заведения

  2. Полученный URL необходимо передать. в поле routeId при Редактировании заведения

  3. По желанию на страницу можно загрузить фоновое изображение размером 600х300 рх. Картинка загружается в Загрузка изображения. Id загруженной картинки необходимо передать в поле backgroundld при Редактировании заведения

Загрузка изображения

Описание: Позволяет загружать изображения в систему

Адрес: https://api.cloudtips.ru/api/images

Тип: POST

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

file

-

Да

Файл с картинкой

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

-

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

imageId

String

Да

Уникальный идентификатор изображения

url

String

Да

Ссылка на изображение

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

{ "imageId": "string", "url": "string" }

Редактирование заведения

Описание: Позволяет отредактировать заведение. Можно передавать одно значение из списка, а не весь список.

Адрес: https://api.cloudtips.ru/api/places/{placeId}, где placeId - уникальный идентификатор заведения

Тип: PATCH

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

name

String

Да

Поиск по названию

placeType

Integer

Нет

Тип завдениея, значения:

 

webSite

String

Нет

Адрес сайта

employeesPage

 

Нет

Страница оплаты заведения

disabled

Boolean

Нет

Отключает страницу оплаты заведения, значения true и false

routeId

String

Нет

Уникальный идентификатор для URL, получаем в Включение страницы со списком всех сотрудников заведения

backgroundld

String

Нет

Фоновая картинка для страницы оплаты заведения, получаем в Загрузка изображения

disabledEmployeeIds

Array of string

Нет

Уникальные идентификаторы сотрудников, которые не должны показываться на странице оплаты заведения

addressInfo

 

Нет

Геоданные заведения

country

String

Нет

Страна

city

String

Нет

Город

address

String

Нет

Улица

latitude

Double

Нет

Широта

longitude

Double

Нет

Долгота

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

[ { "op": "replace", "path": "/Name", "value": "string" }, { "op": "replace", "path": "/PlaceType", "value": "integer" }, { "op": "replace", "path": "/WebSite", "value": "string" }, { "op": "replace", "path": "/EmployeesPage", "value": { "Disabled": "bool", "RouteId": "string", "BackgroundId": "string", "DisabledEmployeeIds": [array of string] } }, { "op": "replace", "path": "/AddressInfo", "value": { "Country": "string", "City": "string", "Address": "string", "Latitude": "double", "Longitude": "double" } } ]

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

succeed

String

Да

Стату запроса

errors

Array of string

Да

Возвращатеся список ошибок, относящихся целиком к запросу

validationErrors

Array of string

Да

Поле представлено в формате ключ-значение и содержит ошибки, которые отнести к конкретному полю запроса

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

{ "succeed": true, "errors": [ "string" ], "validationErrors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] } }

Включение и редактирование рейтинга у заведения

Описание: Включает на странице оплаты блок с рейтингом

Адрес: https://api.cloudtips.ru/api/places/{placeId}/rating, где placeId - уникальный идентификатор заведения

Тип: PATCH

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

RatingSettings

string

Нет

Возможные значения:

False, True

False - рейтинг отключен

True - включен

ComponentIds

Array of string

Нет

Компоненты рейтинга необходимо получить отдельно - Компоненты рейтинга

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

[ { "op": "replace", "path": "/ComponentIds", "value": ["5fe5dd73232c3d447c4eea64","624406cb51770b5d8441051e"] }, { "op": "replace", "path": "/RatingSettings", "value": "string" } ]

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

succeed

String

Да

Стату запроса

errors

Array of string

Да

Возвращатеся список ошибок, относящихся целиком к запросу

validationErrors

Array of string

Да

Поле представлено в формате ключ-значение и содержит ошибки, которые отнести к конкретному полю запроса

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

{ "succeed": true, "errors": [ "string" ], "validationErrors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] } }

Компоненты рейтинга

Описание: Список компонентов рейтинга

Адрес: https://api.cloudtips.ru/api/ratingcomponents

Тип: GET

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

page

Integer

Нет

Пагинация

limit

Integer

Нет

Ограничение на количество записей

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

{ "page" : "integer", "limit" : "integer" }

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

totalCount

Integer

Да

Количество записей

items

 

Да

Записи

id

String

Да

Уникальный идентификатор

title

String

Да

Название

imageId

String

Да

Уникальный идентификатор картинки

imageUrl

String

Да

URL картинки

succeed

String

Да

Стату запроса

errors

Array of string

Да

Возвращатеся список ошибок, относящихся целиком к запросу

validationErrors

Array of string

Да

Поле представлено в формате ключ-значение и содержит ошибки, которые отнести к конкретному полю запроса

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

{ "data": { "totalCount": 0, "items": [ { "id": "string", "title": "string", "imageId": "string", "imageUrl": "string" } ] }, "succeed": true, "errors": [ "string" ], "validationErrors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] } }

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

Описание: получить список получателей по заведению

Адрес: https://api.cloudtips.ru/api/places/{placeId}/employees, где placeId - уникальный идентификатор заведения

Тип: GET

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

placeId

String

Да

Уникальный идентификатор заведения

page

Integer

Нет

Пагинация

limit

Integer

Нет

Ограничение на количество записей

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

{ "placeId": "sring", "page" : "integer", "limit" : "integer" }

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

userId

String

Да

Уникальный идентификатор получателя

name

String

Да

Имя получателя

phoneNumber

String

Да

Телефон получателя

layoutIds

Array of string

Да

Уникальный идентификаторы страниц оплаты получателя

layoutId

String

Да

Уникальный идентификатор визитки

confirmationStatus

Integer

Да

Статус подтверждения привязки

attachedDate

String

Да

Дата и вреямя добавления в заведение

totalCount

Integer

Да

Количество записей

succeed

String

Да

Стату запроса

errors

Array of string

Да

Возвращатеся список ошибок, относящихся целиком к запросу

validationErrors

Array of string

Да

Поле представлено в формате ключ-значение и содержит ошибки, которые отнести к конкретному полю запроса

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

{ "data": { "items": [ { "userId": "string", "name": "string", "phoneNumber": "string", "layoutIds": [ "string" ], "attachedDate": "2021-06-01T11:42:46.902Z" } ], "totalCount": 0 }, "succeed": true, "errors": [ "string" ], "validationErrors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] } }

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

Пользователь должен быть в двух заведениях

Чтобы привязать получателя из своего скоупа и при этом он осталс в старом заведении.

Адрес: https://api.cloudtips.ru/api/places/{placeId}/employees/attach, где placeId - уникальный идентификатор заведения

Тип: POST

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

userIds

Array of string

Да

Уникальный идентификаторы получателя

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

{ "userIds": [ "string" ] }

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

succeed

String

Да

Стату запроса

errors

Array of string

Да

Возвращатеся список ошибок, относящихся целиком к запросу

validationErrors

Array of string

Да

Поле представлено в формате ключ-значение и содержит ошибки, которые отнести к конкретному полю запроса

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

{ "succeed": true, "errors": [ "string" ], "validationErrors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] } }

Пользователь должен быть только в новом заведении

Чтобы перенести получателя из своего скоупа в новое заведение

Адрес: https://api.cloudtips.ru/api/places/{placeId}/layouts/attach, где placeId - уникальный идентификатор заведения

Тип: POST

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

layoutsIds

Array of string

Да

Уникальный идентификаторы визито получателя

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

{ "layoutIds": [ "string" ] }

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

succeed

String

Да

Стату запроса

errors

Array of string

Да

Возвращатеся список ошибок, относящихся целиком к запросу

validationErrors

Array of string

Да

Поле представлено в формате ключ-значение и содержит ошибки, которые отнести к конкретному полю запроса

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

{ "succeed": true, "errors": [ "string" ], "validationErrors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] } }

Отвязка получателя

Описание:Позволяет отвязать получателя от заведения

Адрес: https://api.cloudtips.ru/api/places/{placeId}/employees, где placeId - уникальный идентификатор заведения

Тип: Delete

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

userId

Array of string

Да

Уникальный идентификатор получателя

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

{ "userIds": [ "string" ] }

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

succeed

String

Да

Стату запроса

errors

Array of string

Да

Возвращатеся список ошибок, относящихся целиком к запросу

validationErrors

Array of string

Да

Поле представлено в формате ключ-значение и содержит ошибки, которые отнести к конкретному полю запроса

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

{ "succeed": true, "errors": [ "string" ], "validationErrors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] } }

 

Получение ссылки регистрации

Описание: Позволяет сгенерировать ссылку, которая привяжет пользователя к заведению

Адрес: https://api.cloudtips.ru/api/places/registration-url

Тип: POST

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

placeId

string

Да

Идентификатор заведения

maxRegistrationCount

integer

Нет

Количество регистраций пользователей, доступных по ссылке. Минимальное значение 1, максимальное 100. По умолчанию значение 50

lifetime

integer

Нет

Время жизни ссылки в секундах. Минимальное значение 180 (3 минуты), максимальное 604800 (7 дней). По умолчанию значение 86400 (1 сутки)

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

{ "placeId": "string", "maxRegistrationCount" : "integer", "lifetime" : "integer" }

Ответ:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

succeed

String

Да

Статус запроса

url

String

Да

Ссылка регистрации пользователей

lifetime

integer

Да

Время жизни ссылки в секундах

errors

Array of string

Да

Возвращатеся список ошибок, относящихся целиком к запросу

validationErrors

Array of string

Да

Поле представлено в формате ключ-значение и содержит ошибки, которые отнести к конкретному полю запроса

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

{ "succeed": true, "statusCode": 0, "errors": [ "string" ], "validationErrors": { "additionalProp1": [ "string" ] }, "data": { "url": "string", "lifeTime": "integer" } }

 

Related content