WEB РАЗРАБОТЧИКУ
Пользоваться REST API очень просто.
Обращение к этому URL выдаст Вам все активные предложения лояльности зарегистрированные в системе для демонстрации. Обратите внимание что также поддерживаются SSL соединения. Для этого в каждом запросе нужно изменить протокол на https.
Общее описание
PointLoyalty Manager снабжен API для интеграции со сторонними системами с помощью Web Services и REST.Для интеграции с системой расчета бонусов предварительно необходимо проделать следующие шаги:
- Запустите PointLoyalty Manager и создайте аккаунт в системе.
- Настройте приложение в соответствии с тем как Вы планируете начислять бонусы - определите учитываемые действия пользователей, свойства пользователей, которые могут повлиять на начисление бонусов, категории Ваших товаров и услуг.
- Создайте предложения лояльности - по каким правилам и за какие действия пользователей Вы будете начислять им бонусы.
- Система готова обрабатывать транзакции Ваших пользователей.
ПОДРОБНОЕ ОПИСАНИЕ POINTLOYALTY REST API
Для интеграции с использованием REST API изучите ПОДРОБНОЕ ОПИСАНИЕ.ПРИМЕР ИСПОЛЬЗОВАНИЯ REST API
Пример расчета бонусов
Пусть у вас создана программа лояльности со следующим предложением:
"Всем пользователям, совершившим операцию buy со значением атрибута операции sum больше 1000 назначается бонус равный 5% от значения поля sum".
request = new XMLHttpRequest();
request.open("POST", "http://pointloyalty.com/wl/rest/demo" , true);
var params = "login=" + JSON.stringify(loginObj) + "&actions=" + JSON.stringify(actionsObj) + "&!method=GET";
request.setRequestHeader("Content-length", params.length);
request.setRequestHeader("Connection", "close");
request.setRequestHeader("Content-type", "application/x-www-form-urlencoded");
request.onreadystatechange = function() {
// ...обработка результата
};
request.send(params);
REST API принимает параметры в формате JSON. Так выглядит используемый JSON объект в JavaScript:
request.open("POST", "http://pointloyalty.com/wl/rest/demo" , true);
var params = "login=" + JSON.stringify(loginObj) + "&actions=" + JSON.stringify(actionsObj) + "&!method=GET";
request.setRequestHeader("Content-length", params.length);
request.setRequestHeader("Connection", "close");
request.setRequestHeader("Content-type", "application/x-www-form-urlencoded");
request.onreadystatechange = function() {
// ...обработка результата
};
request.send(params);
var actionsObj = { memberId : Иванов, name : buy,
values : [
{ name: sum,
numericValue : 1100 }
]
}
Попробуйте произвести тот же вызов непосредственно из Вашего браузера: values : [
{ name: sum,
numericValue : 1100 }
]
}
http://www.pointloyalty.ru/wl/rest/demo?login={name:demo,password:demo}&actions={name:buy, memberId:Иванов, values:[{name:sum, numericValue:1100}]}&!output-type=XML
ИНТЕГРАЦИЯ
Интеграция на стороне сервера
Самый простой способ интеграции - это интеграция на стороне сервера. Мы предоставляем библиотеки для следующих платформ:- Java - библиотека Java REST client. Смотри пример использования.
- PHP - библиотека REST client для PHP.
Вы также можете сами разработать средства доступа к PointLoyalty REST сервисам (смотри ПОДРОБНОЕ ОПИСАНИЕ) для любого используемого Вами языка программирования.
Интеграция с клиентской частью (HTML)
Возможно использование PointLoyalty REST API на стороне HTML клиента. Поскольку XMLHttpRequest позволяет делать запросы только на домен с которого был загружен документ, интеграция осуществляется на стороне веб-сервера. Один из способов интеграции - использование http-прокси на Вашем сервере. В зависимости от используемого сервера мы предлагаем использовать следующие прокси:Tomcat/JBoss (Java web server)
Разместите, например, следующий servlet на Вашем сервере и отправляйте все запросы на него.Сервлет будет перенаправлять запросы к REST ресурсам сервера PointLoyalty.
PHP
Если Вы используете PHP, возьмите один из следующих прокси-скриптов.ASP
Если Ваш веб-сервер - Microsoft IIS, используйте первый скрипт с этой страницы.Ваш запрос будет выглядеть как:
http://yourserver.com/proxy.asp?url=<url_encoded_desitnation_url>[&mimeType=<mimeType>]
ПОДДЕРЖКА
Обратите внимание, что система предоставляет консоль для информирования участников программ о начисленных бонусах.По всем видам вопросов, касающихся интеграции обращайтесь в службу технической поддержки компании - support@pointloyalty.ru