Регистрация
Метод "регистрация" (MakeRegistration)
MakeRegistration
https://api.zzap.pro/webservice/datasharing.asmx/MakeRegistration
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
| Параметр | Тип | Обязательный | Описание |
| string | да | e-mail, который будет использоваться в дальнейшем как Ваш login на сайте ZZap | |
| password | string | см. примечание | ваш пароль - пароль должен состоять как минимум из 4 символов |
| code_region | string | да | выбранный вами регион - числовое значение региона определите с помощью метода GetRegions |
| name_first | string | да | имя |
| name_second | string | нет | отчество |
| name_last | string | да | фамилия |
| company_nick | string | нет | ник вашей компании: если заполнено поле, пользователь - юр.лицо, если поле останется пустым, пользователь - физ.лицо |
| phone_code_country | string | да | код страны |
| phone_code_city | string | да | код города |
| phone | string | да | телефон |
| phone_add | string | нет | добавочный |
| email_old | string | см. примечание | e-mail, указанный при регистрации на сайте ZZap |
| password_old | string | см. примечание | ваш пароль от аккаунта на сайте ZZap |
| api_key | string | да | нужно попросить у нас |
Выходные параметры:
| Параметр | Тип | Обязательный | Описание |
| error | string | да | если пусто, ошибок нет |
Примечание:
Для регистрации не надо заполнять email_old и password_old
все остальные поля, кроме name_second, company_nick (если вы физ. лицо) и phone_add, обязательны для заполнения
Для изменения данных обязательно надо заполнить email_old и password_old,
обязательны для заполнения все поля, кроме name_second, company_nick (если вы физ. лицо), phone_add и password
Пример вызова
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/[email protected]&password={password}&code_region=1&name_first=Имя&name_second=Отчество&name_last=Фамилия&company_nick=&phone_code_country=8&phone_code_city=000&phone=111-11-11&phone_add=11&[email protected]&password_old={password_old}&api_key={api_key}
Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "[email protected]" --data-urlencode "password={password}" --data-urlencode "code_region=1" --data-urlencode "name_first=Имя" --data-urlencode "name_second=Отчество" --data-urlencode "name_last=Фамилия" --data-urlencode "company_nick=" --data-urlencode "phone_code_country=8" --data-urlencode "phone_code_city=000" --data-urlencode "phone=111-11-11" --data-urlencode "phone_add=11"--data-urlencode "[email protected]"--data-urlencode "password_old={password_old}" --data-urlencode "api_key={api_key}" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/MakeRegistration
Ответ
{
"error": "", // если пусто, ошибок нет
}
Оформление заказа
Метод "заказ и регистрация" (MakeRegistrationOrderV3)
MakeRegistrationOrderV3
https://api.zzap.pro/webservice/datasharing.asmx/MakeRegistrationOrderV3
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
| Параметр | Тип | Обязательный | Описание |
| login | string | да | e-mail для регистрации на сайте ZZap |
| password | string | да | ваш пароль от аккаунта на сайте ZZap |
| name_first | string | да | имя |
| name_second | string | нет | отчество |
| name_last | string | да | фамилия |
| company_nick | string | нет | ник вашей компании: если заполнено поле, пользователь - юр.лицо, если поле останется пустым, пользователь - физ.лицо |
| phone_code_country | string | да | код страны |
| phone_code_city | string | да | код города |
| phone | string | да | телефон |
| phone_add | string | нет | добавочный |
| client_code_region | string | да | регион покупателя - числовое значение региона определите с помощью метода GetRegions |
| code_doc_b | string | да | внутренний уникальный код предложения (для определения кода используйте метод GetSearchResult) |
| qty_order | string | да | кол-во заказываемой позиции |
| comment | string | нет | дополнительные комментарии относительно заказа |
| notify_sms | string | да | оповещение по смс: false - не оповещать, true - оповещать |
| code_cur | string | да | валюта: цифра от 1 до 5, где 1 - рубль, 2 - доллар, 3 - евро, 4 - гривна, 5 - белорусский рубль, 6 - казахстанский тенге |
| api_key | string | да | нужно попросить у нас |
| test | string | да | true (режим теста): новый пользователь зарегистрирован не будет, заказ не будет сформирован. остальные значения - false (обычный рабочий режим): новый пользователь будет зарегистрирован, заказ будет сформирован и отправлен продавцу |
Выходные параметры:
| Параметр | Тип | Обязательный | Описание |
| error | string | да | если пусто, ошибок нет |
| code_order | int | да | номер сформированного заказа |
Пример вызова
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/MakeRegistrationOrderV3?login={login}&password={password}&name_first=Имя&name_second=Отчество&name_last=Фамилия&company_nick={company_nick}&phone_code_country=8&phone_code_city=000&phone=111-11-11&phone_add=11&client_code_region=30100&code_doc_b=208098711507246&qty_order=1&comment=Заберу в субботу в первой половине дня¬ify_sms=true&code_cur=1&api_key={api_key}&test=true
Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode " --data-urlencode "name_first=Имя" --data-urlencode "name_second=Отчество" --data-urlencode "name_last=Фамилия" --data-urlencode "company_nick={company_nick}" --data-urlencode "phone_code_country=8" --data-urlencode "phone_code_city=000" --data-urlencode "phone=111-11-11" --data-urlencode "phone_add=11" --data-urlencode "client_code_region=30100" --data-urlencode "code_doc_b=208098711507246" --data-urlencode "qty_order=1" --data-urlencode "comment=Заберу в субботу в первой половине дня" --data-urlencode "notify_sms=true" --data-urlencode "code_cur=1"--data-urlencode "api_key={api_key}" --data-urlencode "test=true" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/MakeRegistrationOrderV3
Ответ
{
"error": "", // если пусто, ошибок нет
"code_order": 999999999 // номер сформированного заказа (999999999 - если оформление происходит в режиме теста) }
Очень важно!!! Партнёры, реализующие на своём сайте трансляцию выдачи ZZap с возможностью оформить на их же сайте заказ, для корректного учёта таких заказов в партнёрской статистике должны передавать из данных своего партнёрского аккаунта на ZZap только api_key, а остальные данные запрашивать у пользователя, оформляющего заказ на их сайте.
Метод "сделать заказ" (MakeOrderV4)
MakeOrderV4
https://api.zzap.pro/webservice/datasharing.asmx/MakeOrderV4
Входные параметры (для JSON API передаются в GET или POST параметрах запроса):
| Параметр | Тип | Обязательный | Описание |
| login | string | да | e-mail, указанный при регистрации на сайте ZZap |
| password | string | да | ваш пароль от аккаунта на сайте ZZap |
| code_doc_b | string | да | внутренний уникальный код предложения (для определения кода используйте метод GetSearchResult) |
| qty_order | string | да | кол-во заказываемой позиции |
| client_name | string | да | ФИО заказчика (может отличаться от имени, указанного в аккаунте при регистрации) |
| client_email | string | да | e-mail заказчика (может отличаться от e-mail, указанного в аккаунте при регистрации) |
| client_phone | string | да | телефон заказчика (может отличаться от телефона, указанного в аккаунте при регистрации) |
| comment | string | нет | дополнительные комментарии относительно заказа |
| notify_sms | string | да | оповещение по смс: false - не оповещать, true - оповещать |
| client_code_region | string | да | выбранный регион для заказа (может отличаться от региона, указанного при регистрации) - числовое значение региона определите с помощью метода GetRegions |
| code_cur | string | да | валюта: цифра от 1 до 5, где 1 - рубль, 2 - доллар, 3 - евро, 4 - гривна, 5 - белорусский рубль, 6 - казахстанский тенге |
| name_first | string | да | имя |
| name_second | string | нет | отчество |
| name_last | string | да | фамилия |
| api_key | string | да | нужно попросить у нас |
| test | string | да | true (режим теста): заказ не будет сформирован, остальные значения - false (обычный рабочий режим): заказ будет сформирован и отправлен продавцу |
Выходные параметры:
| Параметр | Тип | Обязательный | Описание |
| error | string | да | если пусто, ошибок нет |
| code_order | int | да | номер сформированного заказа |
Пример вызова
Браузер
https://api.zzap.pro/webservice/datasharing.asmx/MakeOrderV4?login={login}&password={password}&code_doc_b=208098711507246&qty_order=1&client_name=Фамилия Имя&[email protected]&client_phone=8(000)111-11-11&comment=заберу в субботу в первой половине дня¬ify_sms=true&client_code_region=30100&code_cur=1&name_first=Имя&name_second=Отчество&name_last=Фамилия&api_key={api_key}&test=true
Windows через cmd.exe
Chcp 65001
curl.exe --data-urlencode "login={login}" --data-urlencode "password={password}" --data-urlencode "code_doc_b=208098711507246" --data-urlencode "qty_order=1" --data-urlencode "client_name=Фамилия Имя" --data-urlencode "[email protected]" --data-urlencode "client_phone=8(000)111-11-11" --data-urlencode "comment=заберу в субботу в первой половине дня" --data-urlencode "notify_sms=true" --data-urlencode "client_code_region=30100" --data-urlencode "code_cur=1" --data-urlencode "name_first=Имя" --data-urlencode "name_second=Отчество" --data-urlencode "name_last=Фамилия" --data-urlencode "api_key={api_key}" --data-urlencode "test=true" -X POST
https://api.zzap.pro/webservice/datasharing.asmx/MakeOrderV4
Ответ
{
"error": "", // если пусто, ошибок нет
"code_order": 999999999 // номер сформированного заказа (999999999 - если оформление происходит в режиме теста)
}