Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

Тип: GET

Запрос:

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

Тип

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

Описание

createdDateFrom

String

Нет

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

createdDateTo

String

Нет

Посик

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

name

String

Нет

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

administratorId

Array of string

Нет

Поиск по

администратору

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

ids

Array of string

Нет

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

externalPlaceId

String

Нет

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

isHeadPlace

Boolean

Нет

Родительское заведение, значения true и false

page

Integer

Нет

Ппагинация

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

limit

Integer

Нет

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

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

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

Ответ:

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

Тип

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

Описание

id

String

Да

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

externalPlaceId

String

Да

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

createdDate

String

Да

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

updatedDate

String

Да

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

name

String

Да

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

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

placeType

Integer

Да

Тип

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

заведения

managerId

String

Да

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

placeAdministratorId

Array of string

Да

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

isHead

company

Boolean

headPlace

Integer

Да

Головное заведение

Нет

Да

Головное заведение, значения true и false

Компания

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

Да

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

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

Code Block
{
  "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"
        ],
        "isHead": true,
        "headPlace"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:/wiki/api.cloudtips.ru/api/places​/{id}spaces/TIPS/pages/1787396098

Тип: GET

Запрос:

-

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

-

Ответ:

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

Тип

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

Описание

id

String

Да

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

externalPlaceId

String

Да

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

createdDate

String

Да

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

updatedDate

String

Да

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

name

String

Да

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

placeType

Integer

Да

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

 

managerId

String

Да

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

placeAdministrators

 

Да

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

userId

String

Да

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

name

String

Да

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

isHead

Boolean

Да

Головное заведение, значения true и false

headPlace

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

Да

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

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

Code Block
{
  "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",
    "isHead": true,
    "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
    },
    "childPlacescompany": [
      {
        "id": "string",
        "name": "string"
      }
    ],
    "headPlace": {
      "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

Да

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

externalPlaceId

externalInfo.id

String

Нет

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

placeType

Integer

Нет

Тип

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

заведения

placeAdministratorId

Array of string

Нет

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

employeesPage

 

Нет

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

routeId

String

Нет

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

backgroundUrl

String

Нет

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

childPlaceIds

companyId

Array of string

isHead

Boolean

Нет

Головное заведение, значения true и false

webSite

String

Нет

Адрес сайта

String

Нет

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

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

webSite

String

Нет

Адрес сайта

comment

String

Нет

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

addressInfo

String

Нет

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

country

String

Нет

Страна

city

String

Нет

Город

address

String

Нет

Улица

latitude

Integer

Нет

Широта

longitude

Integer

Нет

Долгота

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

Code Block
{
  "name": "string",
  "externalInfo": {
    "externalPlaceIdid": "string"
  },
  "placeType": 0,
  "managerId": "string",
  "placeAdministratorIds": [
    "string"
  ],
  "employeesPage": {
    "routeId": "string",
    "backgroundUrl": "string"
  },
  "childPlaceIdscompanyId": [
    "string"
  ],
  "isHead": true,
  "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

Да

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

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

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

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

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

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

Тип: POST

Запрос:

...

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

...

Тип

...

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

...

Описание

...

email

...

String

...

Да

...

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

...

phoneNumber

...

String

...

Нет

...

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

...

name

...

String

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

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

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

Code Block
languagejson
{
  "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

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

Code Block
{
  "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

Нет

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

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

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

...

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

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

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

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

...

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

Тип: POST

Запрос:

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

Тип

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

Описание

file

-

Да

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

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

-

Ответ:

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

Тип

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

Описание

imageId

String

Да

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

url

String

Да

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

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

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

...

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

Адрес: https: /wiki/api.cloudtips.ru/api/places​/{placeId}spaces/TIPS/pages/1787396098, где 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

Нет

Долгота

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

Code Block
[
    {
        "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

Да

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

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

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

...

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

Тип: PUTPATCH

Запрос:

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

Тип

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

Описание

RatingSettings

string

enabled

Нет

Boolean

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

Да
Code Block

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

componentIds
False,
True

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

True - включен

ComponentIds

Array of string

Нет

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

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

Code Block
[
  {
    "enabledop": true"replace",
    "componentIdspath": ["/ComponentIds",
    "stringvalue":  ["5fe5dd73232c3d447c4eea64","624406cb51770b5d8441051e"]
 ] }

...

,
  {
    "op": "replace",
    "path": "/RatingSettings",
    "value":  "string"
  }
]

Ответ:

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

Тип

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

Описание

succeed

String

Да

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

errors

Array of string

Да

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

validationErrors

Array of string

Да

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

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

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

...

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

Тип: GET

Запрос:

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

Тип

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

Описание

page

Integer

Нет

Пагинация

limit

Integer

Нет

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

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

Code Block
{
    "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

Да

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

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

Code Block
{
  "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}/ratingemployees, где placeId - уникальный идентификатор заведения

Тип: DELETEGET

Запрос:

-

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

-

Ответ:

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

Тип

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

Описание

succeed

placeId

String

Да

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

errors

Array of string

Да

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

validationErrors

Array of string

Да

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

...

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

page

Integer

Нет

Пагинация

limit

Integer

Нет

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

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

Code Block
{
  "succeedplaceId": true"sring",
  "errorspage" : [
    "stringinteger"
  ],
  "validationErrorslimit": {     "additionalProp1": [
      "stringinteger"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  }
}

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

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

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

Тип: GET

Запрос:

...

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

...

Тип

...

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

...

Описание

...

}

Ответ:

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

Тип

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

Описание

userId

String

Да

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

name

String

Да

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

phoneNumber

String

Да

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

layoutIds

Array of string

Да

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

layoutId

String

Да

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

заведения

визитки

page

confirmationStatus

Integer

Нет

Да

Пагинация

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

limit

attachedDate

Integer

String

Нет

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

...

Да

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

totalCount

Integer

Да

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

succeed

String

Да

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

errors

Array of string

Да

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

validationErrors

Array of string

Да

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

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

Code Block
{
  "placeIddata": "sring", {
    "pageitems" : "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

...

Да

...

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

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

Code Block
{
  "data": {
    "items": [
      {
        "userId": "string",
        "name": "string",
        "phoneNumber": "string",
        "layoutIds": [
        {
        "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

Да

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

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

Code Block
{
  "userIds": [
    "string"
   
    ],
        "attachedDate": "2021-06-01T11:42:46.902Z"
      }
    ],
    "totalCount": 0
  },
  }

Ответ:

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

Тип

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

Описание

succeed

String

Да

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

errors

Array of string

Да

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

validationErrors

Array of string

Да

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

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

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

...

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

...

новом заведении

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

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

Тип: POST

Запрос:

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

Тип

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

Описание

userIds

layoutsIds

Array of string

Да

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

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

Code Block
{
  "userIdslayoutIds": [
    "string"
  ]
}

Ответ:

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

Тип

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

Описание

succeed

String

Да

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

errors

Array of string

Да

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

validationErrors

Array of string

Да

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

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

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

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

...

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

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

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

Тип: POSTDelete

Запрос:

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

Тип

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

Описание

layoutsIds

userId

Array of string

Да

Уникальный

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

идентификатор получателя

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

Code Block
{
  "layoutIdsuserIds": [
    "string"
  ]
}

Ответ:

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

Тип

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

Описание

succeed

String

Да

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

errors

Array of string

Да

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

validationErrors

Array of string

Да

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

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

Code Block
{
  "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

...

Да

...

registration-url

Тип: POST

Запрос:

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

Тип

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

Описание

placeId

string

Да

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

maxRegistrationCount

integer

Нет

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

lifetime

integer

Нет

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

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

Code Block
languagejson
{
  "userIdsplaceId": [
  "string",
  "maxRegistrationCount" : "integer",
  "stringlifetime" :  ]"integer"
}

Ответ:

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

Тип

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

Описание

succeed

String

Да

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

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

url

String

Да

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

lifetime

integer

Да

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

errors

Array of string

Да

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

validationErrors

Array of string

Да

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

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

Code Block
languagejson
{
  "succeed": true,
  "statusCode": 0,
  "errors": [
    "string"
  ],
  "validationErrors": {
    "additionalProp1": [
      "string"
    ],
  },
  "additionalProp2data": [{
    "url":  "string"
    ],
    "additionalProp3lifeTime": [
      "string"
    ]integer"
  }
}