Versions Compared

Key

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

С помощью данного API вы можете просматривать, находить, добавлять, редактировать, объединять и удалять контакты в проекте.

...

Code Block
GET https://api.smartsender.com/v1/contacts

 
Основные параметры:

Название

Описание

Валидация

page

Запрашиваемая страница

Минимальное значение 1

limitation

Количество данных для вывода на странице

Минимальное значение 1, максимальное 20

 
В случае успешного ответа получите следующее:

Code Block
{
    "cursor": Cursor,
    "collection": Contact[]
}


Описание ответа:

Название

Описание

cursor

Объект типа Cursor

collection

Массив объектов типа Contact

Поиск.

Позволяет найти совпадения по контактам с помощью ключевого слова.

Code Block
GET https://api.smartsender.com/v1/contacts/search

 
Основные параметры:

Название

Описание

Валидация

page

Запрашиваемая страница

Минимальное значение 1

limitation

Количество данных для вывода на странице

Минимальное значение 1, максимальное 20

term

Ключевое слово для поиска

Не пустое

 
В случае успешного ответа получите следующее:

Code Block
{
    "cursor": Cursor,
    "collection": Contact[]
}


Описание ответа:

Название

Описание

cursor

Объект типа Cursor

collection

Массив объектов типа Contact

Поиск по ID.

Получение информации о контакте по идентификатору.

...

Code Block
GET https://api.smartsender.com/v1/contacts/{contactId}/gates

 
Основные параметры:

Название

Описание

Валидация

page

Запрашиваемая страница

Минимальное значение 1

limitation

Количество данных для вывода на странице

Минимальное значение 1, максимальное 20

 
В случае успешного ответа получите следующее:

Code Block
{
    "cursor": Cursor,
    "collection": Gate[]
}


Описание ответа:

Название

Описание

cursor

Объект типа Cursor

collection

Массив объектов типа Gate

Обновление.

Обновляет данные выбранного клиента.

...

 
Основные параметры: Укажите все необходимые параметры для обновления в теле запроса. Это могут быть как и переменные, так и системные поля.


Основные параметры:

Название

Тип

Описание

values

Объект (ключ-значение)

Все необходимые параметры для обновления в теле запроса. Это могут быть как и переменные, так и системные поля.

Важно! Если указано не верное значение для обновления поля, поле будет пропущено и остальное обновление будет обработано.

В случае успешного ответа получите следующее:

...

Code Block
POST https://api.smartsender.com/v1/contacts/{contactId}/fire

  
Основные параметры:

Название

Описание

name

Название события, регистр имеет значение

В случае успешного ответа получите следующее:

...

Code Block
{
    "state": true
}

 

(DEPRECATED) Удаление.

Позволяет удалить выбранного контакта.

...

Code Block
{
    "state": true
}

 

Создание.

Создание контакта доступно только для платформы Smart Messenger с использованием Channels API (создание шлюза). Для этого Вам необходим идентификатор канала.