Сообщения

Метод «мои собеседники» (GetMyMessagesThreadsV3)

GetMyMessagesThreadsV3
https://www.zzap.ru/webservice/datasharing.asmx/GetMyMessagesThreadsV3

Входные параметры (для JSON API передаются в GET или POST параметрах запроса):

Параметр Тип Обязательный Описание
login string да e-mail, указанный при регистрации на сайте ZZap
password string да ваш пароль от аккаунта на сайте ZZap
login_info string да для внутренних целей, передавать пустое значение
user_key_reply string да для внутренних целей, передавать пустое значение
code_object string да для внутренних целей, передавать пустое значение
type_object string да для внутренних целей, передавать пустое значение
api_key string да нужно попросить у нас
call_data string да для внутренних целей, передавать пустое значение



Выходные параметры:

Параметр Тип Обязательный Описание
error string да если пусто, ошибок нет
row_count int да сколько строк вернулось
table Массив GetMessagesThreadItem[] да Массив данных



GetMessagesThreadItem:

Параметр Тип Обязательный Описание
user_name string да ФИО (или название компании) собеседника
unread_count string да количество непрочитанных сообщений
user_key string да «ключ» собеседника, с помощью которого вы сможете посмотреть полную переписку с этим собеседником (метод GetMyMessages),
message_last_date DateTime да дата последнего сообщения с этим собеседником
message_last string да текст последнего сообщения с этим собеседником
read_only bool да можно ли этому собеседнику отсылать сообщения: false — можно, true — нельзя



Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetMyMessagesThreadsV3?login={login}&password={password}&login_info=&user_key_reply=&code_object=&type_object=&api_key={api_key}&call_data=

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «login_info=» —data-urlencode «user_key_reply=» —data-urlencode «code_object=» —data-urlencode «code_object=» —data-urlencode «api_key={api_key}» —data-urlencode «call_data=» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetMyMessagesThreadsV3

Ответ
{
«error»: «» // если пусто, ошибок нет
«row_count»: 5, // сколько строк вернулось
«table»:
[
{
«user_name»: «фамилия имя», // ФИО (или название компании) собеседника
«unread_count»: 9, // количество непрочитанных сообщений
«user_key»: «?????????????????», // «ключ» собеседника, с помощью которого Вы сможете посмотреть полную переписку с этим собеседником (метод GetMyMessages), а также можете посмотреть информацию о продавце/покупателе (метод GetUserInfo)
«message_last_date»: «2017-06-30T16:17:24», // дата последнего сообщения с этим собеседником
«message_last»: «Текст последнего сообщения с этим собеседником»
«read_only»: false, // можно ли этому собеседнику отсылать сообщения: false — можно, true — нельзя
},
{

}
]
}



Метод «мои сообщения» (GetMyMessagesV3)

GetMyMessagesV3
https://www.zzap.ru/webservice/datasharing.asmx/GetMyMessagesV3

Входные параметры (для JSON API передаются в GET или POST параметрах запроса):

Параметр Тип Обязательный Описание
login string да e-mail, указанный при регистрации на сайте ZZap
password string да ваш пароль от аккаунта на сайте ZZap
login_info string да для внутренних целей, передавать пустое значение
row_count string нет сколько максимально записей возвращать (по умолчанию 100 записей)
user_key string да «ключ» собеседника, полученный в методе GetMyMessagesThreads (или в методах GetSearchResult, GetSearchResultOne, GetMyOrders, GetMyVinRequestReplies)
code_object string да для внутренних целей, передавать пустое значение
type_object string да для внутренних целей, передавать пустое значение
api_key string да нужно попросить у нас
call_data string да для внутренних целей, передавать пустое значение



Выходные параметры:

Параметр Тип Обязательный Описание
error string да если пусто, ошибок нет
row_count int да сколько строк вернулось
table Массив GetMessageItem[] да Массив данных



GetMessageItem:

Параметр Тип Обязательный Описание
user_key string да «ключ» отправителя сообщения
user_name string да ФИО (или название компании) отправителя сообщения
message_date DateTime да дата сообщения
message string да «Текст сообщения»
unread bool да false — прочитано получателем, true — не прочитано получателем



Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/GetMyMessagesV3?login={login}&password={password}&login_info=&row_count=50&user_key={user_key}&code_object=&type_object=&api_key={api_key}&call_data=

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «login_info=» —data-urlencode «row_count=50» —data-urlencode «user_key={user_key}» —data-urlencode «code_object=» —data-urlencode «type_object=» —data-urlencode «api_key={api_key}» —data-urlencode «call_data=» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/GetMyMessagesV3

Ответ
{
«error»: «» // если пусто, ошибок нет
«row_count»: 100, // сколько строк вернулось
«table»:
[
{
«user_key»: «?????????????????», // «ключ» отправителя сообщения
«user_name»: «фамилия имя», // ФИО (или название компании) отправителя сообщения
«message_date»: «2017-06-30T16:17:24», // дата сообщения
«message»: «Текст сообщения»
«unread»: true, // false — прочитано получателем, true — не прочитано получателем
},
{

}
]
}



Метод «отправка сообщения» (SendMessageV2)

SendMessageV2 https://www.zzap.ru/webservice/datasharing.asmx/SendMessageV2

Входные параметры (для JSON API передаются в GET или POST параметрах запроса):

Параметр Тип Обязательный Описание
login string да e-mail, указанный при регистрации на сайте ZZap
password string да ваш пароль от аккаунта на сайте ZZap
login_info string да для внутренних целей, передавать пустое значение
user_key string да «ключ» собеседника, полученный в методе GetMyMessagesThreads (или в методах GetSearchResult, GetSearchResultOne, GetMyOrders, GetMyVinRequestReplies)
message string да текст сообщения
message_date string нет дата сообщения (по умолчанию текущая дата)
isonline string да false — собеседник офлайн, true — собеседник онлайн
code_object string да для внутренних целей, передавать пустое значение
type_object string да для внутренних целей, передавать пустое значение
api_key string да нужно попросить у нас



Выходные параметры:

Параметр Тип Обязательный Описание
error string да если пусто, ошибок нет



Пример вызова
Браузер
https://www.zzap.ru/webservice/datasharing.asmx/SendMessageV2?login={login}&password={password}&login_info=&user_key={user_key}&message=Текст сообщения&message_date=2017-06-30T16:17:24&isonline=false&code_object=&type_object=&api_key={api_key}

Windows через cmd.exe
Chcp 65001
curl.exe —data-urlencode «login={login}» —data-urlencode «password={password}» —data-urlencode «login_info=» —data-urlencode «user_key={user_key}» —data-urlencode «message=Текст сообщения» —data-urlencode «message_date=2017-06-30T16:17:24» —data-urlencode «isonline=false» —data-urlencode «code_object=» —data-urlencode «type_object=» —data-urlencode «api_key={api_key}» -X POST
https://www.zzap.ru/webservice/datasharing.asmx/SendMessageV2

Ответ
{
«error»: «» // если пусто, ошибок нет
}

Сообщения