Просмотров: 23154
Дата последнего изменения: 23.09.2021
Сложность урока:
3 уровень - средняя сложность. Необходимо внимание и немного подумать.
4
5
Скрипт и входные параметры
Создатель модуля имеет возможность автоматической работы с клиентами своего модуля. Функционал в полном объёме доступен только для платных модулей. Для бесплатных модулей есть возможность получать информацию о клиенте после их установки клиентом (метод action=list).
Реализуется функционал с помощью специального скрипта: http://partners.1c-bitrix.ru/add_client.php.
| Входные параметры |
| partner_id | ID партнера на нашем сайте (обязательный) |
| module_id | код модуля (обязательный) |
| key | хэш ключа (передается вам клиентом) |
| name | название клиента |
| email | email клиента |
| site_url | адрес сайта клиента |
| contact_person | контактное лицо |
| phone | телефон клиента |
| comments | произвольные комментарии (метод оплаты, описание клиента и т.п.) |
| action | действие:
- add - добавить клиента;
- delete - удалить клиента (отвязать решение от ключа);
- update - обновить клиента;
- check - проверка, что решение доступно для указанного ключа
- list - получить список клиентов указанного решения
Если действие не задано, то происходит добавление нового клиента.
|
| hash | подпись запроса, формируется следующим образом:
$md5 = md5($partner_id."|".$module_id."|".$key."|".$action."|".$salt);
|
| $salt | "Пароль для подписи данных", задается в карточке партнера |
| is_utf | если значение "Y", то все входные параметры будут перекодированы из UTF-8 в кодировку нашего сайта (windows-1251) |
|
Результат работы
Скрипт возвращает два типа ответа (в текстовом формате):
OK
сообщение об успешно совершенном действии
ERROR
текст ошибки
Примеры использования
//Добавим нового клиента
http://partners.1c-bitrix.ru/add_client.php?partner_id=&module_id=&key=&action=add&name=Anton%20Ezhkov&email=anton@bitrix.ru&site_url=www.1c-bitrix.ru&contact_person=Anton%20Ezhkov&phone=123123123&comments=Оплатил безналом&is_utf=Y&hash=
//Изменим информацию о клиенте
http://partners.1c-bitrix.ru/add_client.php?partner_id=&module_id=&key=&action=update&name=Антон Ежков&email=anton@bitrix.ru&site_url=www.1c-bitrix.ru&contact_person=Антон Ежков&phone=123123123&comments=Оплатил безналом, помогал в техподдержке&is_utf=Y&hash=
//Удалим ключ из клиентов модуля
http://partners.1c-bitrix.ru/add_client.php?partner_id=&module_id=&key=&action=delete&hash=
//Получим список клиентов указанного платного модуля
http://partners.1c-bitrix.ru/add_client.php?partner_id=&action=list&module_id=&hash=
