Сообщения

Главная > Помощь > Сообщения

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

GetMyMessagesThreadsV3
https://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/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://api.zzap.pro/webservice/datasharing.asmx/SendMessageV2

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

Сообщения