Versions Compared

Version Old Version 26 New Version 27
Changes made by

Anton Sukhorukov

Anton Sukhorukov

Saved on

Key

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

...

Адрес: https://api.cloudtips.ru/api/receivers/create-many

Тип: POST

Запрос:

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

Тип

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

Описание

placeId

String

Да

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

needConfirmLayouts

bool(default false)

Нет

При значение true, всегда будет создана визитка со статусом ожидания подтверждения

receivers

 

 

Список получателей

phoneNumber

String

Да

Номер получателя

name

String

Да

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

externalId

String

Нет

Идентификатор сотрудника, уникальный в рамках компании

sendPassword

bool(default false)

Нет

Необходимо ли отправлять уведомление, только что зарегистрированному получателю

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

Code Block
{
  "placeId": "string",
  "needConfirmLayouts" : true
  "receivers": [
    {
      "phoneNumber": "string",
      "name": "string",
      "externalId": "string",
      "sendPassword": true
    }
  ]
}

Ответ:

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

Тип

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

Описание

created

 

 

Созданные получатели

phoneNumber

String

Да

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

name

String

Да

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

userId

String

Да

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

layoutId

String

Да

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

layoutStatus

Enum

Да

Статус получателя

0 - None (Не запрашивалось подтверждение)

1 - Confirmed (Подтвреждена)

2 - WaitingForConfirmation (Ожидает подтверждения)

3 - Declined (Отклонена)

skipped

 

 

Пользователи уже есть в системе и в скоупе

phoneNumber

String

Да

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

name

String

Да

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

userId

String

Да

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

layoutId

String

Да

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

layoutStatus

Enum

Да

Статус получателя

succeed

String

Да

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

errors

Array of string

Да

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

validationErrors

Array of string

Да

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

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

Code Block
{
  "data": {
    "created": [
      {
        "phoneNumber": "string",
        "name": "string",
        "userId": "string",
        "layoutId": "string",
        "layoutStatus": 0
      }
    ],
    "skipped": [
      {
        "phoneNumber": "string",
        "name": "string",
        "userId": "string",
        "layoutId": "string",
        "layoutStatus": 0
      }
    ]
  },
  "succeed": true,
  "errorCode": 0,
  "errors": [
    "string"
  ],
  "validationErrors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  }
}

...

Тип: POST, хедер Content-Type=multipart/form-data;
Запрос:

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

Тип

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

Описание

FormFile

file

Да

Файл с фотографией

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

-

Ответ:

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

Тип

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

Описание

photoUrl

String

Да

Урл загруженой аватарки

photoId

String

Да

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

succeed

String

Да

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

errors

Array of string

Да

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

validationErrors

Array of string

Да

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

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

Code Block
{
  "data": {
     "photoUrl": "string",
     "photold": "string"
  },
  "succeed": true,
  "errors": [
    "string"
  ],
  "validationErrors": {
    "additionalProp1": [
      "string"
    ]
  }
}

...

Тип: DELETE
Запрос:

-

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

-

Ответ:

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

Тип

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

Описание

succeed

String

Да

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

errors

Array of string

Да

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

validationErrors

Array of string

Да

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

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

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

...

Адрес: https://api.cloudtips.ru/api/receivers​/{userId}, где userId уникальный идентификатор получателя в системе

Тип: PATCH

Запрос:

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

Тип

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

Описание

Name

String

Да

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

Email

String

Да

Email получателя

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

Code Block
[
  {
    "op": "replace",
    "path": "/Name",
    "value":  "string"
  },
  {
    "op": "replace",
    "path": "/Email",
    "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"
    ]
  }
}

...

Info

Ранее используемый https://api.cloudtips.ru/api/receivers/pages также продолжает поддерживаться

Тип: GET

Запрос:

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

Тип

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

Описание

dateFrom

String

Нет

Дата и время начала поиска

dateTo

String

Нет

Дата и время окончания поиска

phoneNumber

String

Нет

Телефонный номер получателя

name

String

Нет

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

layoutId

String

Нет

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

placeId

String

Нет

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

type

Enum

Нет

Тип получателя

userId

Array of string

Нет

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

page

Integer

Нет

Страница

limit

Integer

Нет

Ограничение на страницу

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

Code Block
{
  "dateFrom": "string",
  "dateTo": "string",
  "phoneNumber": "string",
  "name": "string",
  "layoutId": "string",
  "placeId": "string",
  "type": "",
  "userId": [
      "string"
    ],
  "page": "integer",
  "limit": "integer"
}

Ответ:

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

Тип

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

Описание

userId

String

Да

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

phoneNumber

String

Да

Номер получателя

email

String

Да

Email получателя

fullName

String

Да

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

type

Integer

Да

Тип получателя

layouts

String

Да

Список страниц оплаты

id

String

Да

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

layoutId

String

Да

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

default

Boolean

Да

Страница оплаты по умолчанию, значения true и false

disabled

Boolean

Да

Страница оплаты удалена, значения true и false

title

String

Да

Название страницы оплаты, используется только в лк получателя

description

String

Да

Описание страницы оплаты, используется на первом экране страницы оплаты

text

String

Да

Не используется

backgroundId

String

Да

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

placeId

String

Да

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

placeName

String

Да

Название заведения

externalInfo

String

Да

Идентификатор из внешней системы

manager

String

Да

Менеджер получателя

managerId

String

Да

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

name

String

Да

Имя менеджера

email

String

Да

Email менеджера

photoId

String

Да

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

photoUrl

String

Да

Ссылка на аватарку получателя

cardFirstSix

String

Да

Первые 6 цифр карты получателя

cardLastFour

String

Да

Последние 4 цифры карты получателя

cardExpDate

String

Да

Дата окончания действия карты

payoutMethod

Integer

Да

Метод выплаты чаевых получателю

lockoutEnd

String

Да

Дата окончания блокировки получателя

phoneNumberConfirmed

Boolean

Да

Подтверждение номера телефона, значения true и false

createdDate

String

Да

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

updatedDate

String

Да

Дата и время редактирования получателя

totalCount

Integer

Да

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

succeed

String

Да

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

errors

Array of string

Да

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

validationErrors

Array of string

Да

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

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

Code Block
{  
  {
    "items": [
      {
        "userId": "string",
        "phoneNumber": "string",
        "email": "string",
        "fullName": "string",
        "type": 0,
        "layouts": [
          {
            "id": "string",
            "shortId": "string",
            "default": true,
            "disabled": true,
            "title": "string",
            "description": "string",
            "text": "string",
            "backgroundId": "string",
            "placeId": ""string",
            "placeName": "string",
            "userId": "string"
            "externalInfo": "string"
          }
        ],
        "manager": {
          "managerId": "string",
          "name": "string",
          "externalId": "string",
          "email": "string"
        },
        "photoId": "string",
        "photoUrl": "string",
        "cardFirstSix": "string",
        "cardLastFour": "string",
        "cardExpDate": "string",
        "payoutMethod": 0,
        "lockoutEnd": "2021-05-27T12:37:53.822Z",
        "phoneNumberConfirmed": true,
        "createdDate": "2021-05-27T12:37:53.822Z",
        "updatedDate": "2021-05-27T12:37:53.822Z"
      }
    ],
    "totalCount": 0
  },
  "succeed": true,
    "errors": [
      "string"
    ],
    "validationErrors": {
      "additionalProp1": [
        "string"
      ],
      "additionalProp2": [
        "string"
      ],
      "additionalProp3": [
        "string"
      ]
}

...

Адрес: https://api.cloudtips.ru/api/receivers/{userId}/payout-method, где userId - уникальный идентификатор получателя

Тип: POST

Запрос:

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

Тип

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

Описание

payoutMethod

Integer

Да

Метод выплаты чаевых получателю:

0 - мгновенный,

1 - накопление

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

Code Block
{
  "payoutMethod": 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/receivers/{userId}/detach-agent, где userId уникальный идентификатор получателя

Тип: POST

Запрос:

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

Тип

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

Описание

userId

String

Да

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

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

-

Ответ:

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

Тип

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

Описание

succeed

String

Да

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

errors

Array of string

Да

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

validationErrors

Array of string

Да

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

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

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

...