Метод "мои собеседники" (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) |
| 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) |
| 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": "" // если пусто, ошибок нет
}