36  /  36

Скрипт для автоматической работы с клиентами модуля

Просмотров: 14787
Дата последнего изменения: 23.09.2021
Сложность урока:
3 уровень - средняя сложность. Необходимо внимание и немного подумать.
1
2
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=

8
Курсы разработаны в компании «1С-Битрикс»

Если вы нашли неточность в тексте, непонятное объяснение, пожалуйста, сообщите нам об этом в комментариях.
Развернуть комментарии