Заведения
- 1 Получение списка заведений
- 2 Получение информации по заведению
- 3 Создание заведения
- 3.1 Возможные ошибки
- 4 Создание управляющего заведения
- 5 Включение страницы со списком всех сотрудников заведения
- 6 Загрузка изображения
- 7 Редактирование заведения
- 8 Включение и редактирование рейтинга у заведения
- 9 Компоненты рейтинга
- 10 Получение списка сотрудников заведения
- 11 Привязка получателя к заведению
- 12 Отвязка получателя
- 13 Получение ссылки регистрации
Получение списка заведений
Описание: Позволяет получить информацию по всем заведениям ТСП
Адрес: 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"
]
}
}
Возможные ошибки
Создание управляющего заведения
Описание: создание управляющего для заведения
Адрес: https://api.cloudtips.ru/api/place-administrators
Тип: POST
Запрос:
Наименование | Тип | Обязательность | Описание |
---|---|---|---|
String | Да | Email управляющего | |
phoneNumber | String | Нет | Номер телефона управляющего |
name | String | Да | Имя управляющего |
managerId | String | Нет | Уникальный идентификатор менеджера |
placeIds | Array of string | Нет | Уникальные идентификаторы заведений |
permissions | Integer(int32) | Нет | Разрешения применяемые к управляющему Доступные значения(enum):
|
Пример запроса:
{
"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"
}
}
Включение страницы со списком всех сотрудников заведения
Описание: Позволяет включить страницу со списком всех сотрудников заведения. Для включения необходимо:
Сделать запрос GET https://api.cloudtips.ru/api/places/{placeId}/payment-pages/urls/generate, передав уникальный идентификатор заведения
Полученный URL необходимо передать. в поле routeId при Редактировании заведения
По желанию на страницу можно загрузить фоновое изображение размером 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"
}
}