Интерфейс используется для автоматической работы магазинов и бирж. С его помощью можно в автоматическом режиме выставлять и удалять счета, переводить кредиты, проверять статус трансакций.

Интерфейс соблюдает требования безопасности, принятые в Uniq-IP. Для выставления и проверки счетов применяется логин и пароль в системе, а для прямого перевода кредитов ещё и ключевой файл. При этом ни пароль, ни ключевой файл в запросах не передаются, а для идентификации применяется цифровая подпись. Для работы с автоматическим интерфейсом нужно дать заявку администратору.

1. Термины и определения

Трансакция — процесс, который может включать следующие этапы: выставление счёта, подтверждение перевода, или прямой перевод кредитов (UNIQ) со счёта на счёт в сервисе Uniq-IP.

Сервер TransUNIQ — обработчик http://www.uniq-ip.com/cgi-bin/transuniq/auto.cgi на который передаются параметры запроса с сервера продавца или от клиента, а также, который передаёт результаты успешной трансакции на сервер продавца.

Сервер продавца (Продавец) — посылает запросы на сервер TransUNIQ на проведение трансакции, а также ряд других запросов, получает результат успешно проведенной трансакции, и, выдаёт после этого, товар покупателю. Обработчик запросов на этот сервер имеет конкретный адрес в сети (url_quest).

Клиент (Покупатель) — броузер, с помощью которого пользователь производит активные действия: инициирование трансакции, подтверждение перевода и получение товара.

url_ok — URL, на который переадресуется броузер покупателя в случае успешной трансакции.

* Термины: Продавец, Покупатель и Товар здесь имеют условные значения, и используются только для простоты восприятия. Так, в случае с автоматическим интерфейсом Uniq-IP <-> Биржа, в качестве продавца будет выступать сервер биржи, а в качестве товара, например, титульные знаки Webmoney.

Запрос может быть передан на сервер TransUNIQ методом POST (желательно) или GET. При формировании запроса нужно помнить, что URL-адреса изображаются в стандартной ASCII-кодировке, поэтому используемые специальные символы подлежат замене шестнадцатеричными ASCII-кодами. Это, впрочем, не относится к запросу №2 таблицы в том случае, если форма передаётся броузером (броузер всё, что необходимо перекодирует автоматически).

Пример №1. Выставление счёта
Возьмём запрос №1 из таблицы и следующие параметры:

type=bill
logFrom=Sasha
logTo=Fedya
sum=100
comment=подарок
pasFrom=Tk567

Далее нужно сформировать цифровую подпись из строки, а сама строка «склеивается» из значений параметров. Получаем строку: billSashaFedya100подарокTk567
Получаем цифровую подпись (подробнее см. ниже): sign=df348a4a0e4dd8ac4d670b041c67bd30

Поскольку значение параметра "comment" содержит специальные символы, то для передачи по HTTP мы их должны перекодировать. Новый comment=%EF%EE%E4%E0%F0%EE%EA

Далее формируем запрос методом GET:
http://www.uniq-ip.com/cgi-bin/transuniq/auto.cgi?type=bill&logFrom=Sasha&logTo=Fedya&sum=100&comment=%EF%EE%E4%E0%F0%EE%EA&sign=df348a4a0e4dd8ac4d670b041c67bd30

Внимание. При формировании строки значения параметров распологаются в порядке таблицы. Если какой-нибудь параметр отсутствует, то он просто пропускается.

Внимание. Автоматический интерфейс для логина работает только, если он разрешён администратором Uniq-IP!

Цифровая подпись формируется путём «склеивания» значений основных параметров в строку, в том порядке, в котором они указаны в таблице. Если какой-нибудь из параметров отсутствует, то строка формируется без него. Из полученной таким образом строки формируется хеш-функция, которая и представляет собой цифровую подпись.

Хеш-функция — это последовательность из 32-х шестнадцатеричных цифр в соответствии с широко распространенным алгоритмом Message Digest 5 (MD5), разработанным Ron Rivest из MIT Laboratory for Computer Science и RSA Data Security, Inc. Алгоритм был опубликован в сети Интернет в апреле 1992 года (RFC 1321).

Пример №2. Проверка суммы на Общем счёте логина Sasha
Возьмём запрос №6 из таблицы и следующие параметры:

type=verify
logFrom=Sasha
pasFrom=Tk567

«Склеиваем» данные и получаем следующую строку: verifySashaTk567
Получаем из неё цифровую подпись: sign=0c9a8f29d42b9ee5138d1f3ac9932e51
Передаём запрос на сервер TransUNIQ:
http://www.uniq-ip.com/cgi-bin/transuniq/auto.cgi?type=verify&logFrom=Sasha&sign=0c9a8f29d42b9ee5138d1f3ac9932e51

Обратите внимание: pasFrom участвует только в формировании цифровой подписи, но в запросе на сервер не передаётся!

Пример №3. Перевод 100 UNIQ с логина Sasha на логин Fedya
Возьмём запрос №7 из таблицы и следующие параметры:

type=trans
logFrom=Sasha
logTo=Fedya
sum=100
comment=present
pasFrom=Tk567
keyFrom=fbb6cf1694f82af9742ac568735d94c8421c6a55 (содержимое ключевого файла у Sasha)

«Склеиваем» данные и получаем следующую строку: transSashaFedya100presentTk567fbb6cf1694f82af9742ac568735d94c8421c6a55
Получаем из неё цифровую подпись: sign=ae249aedafe8f9d1be24520409316078
Передаём запрос на сервер TransUNIQ:
http://www.uniq-ip.com/cgi-bin/transuniq/auto.cgi?type=trans&logFrom=Sasha&logTo=Fedya&sum=100&comment=present&sign=ae249aedafe8f9d1be24520409316078

Обратите внимание: pasFrom и keyFrom участвуют только в формировании цифровой подписи, но в запросе на сервер не передаются!

Потренироваться в получении цифровой подписи вам поможет эта страничка.

Все запросы, в случае их обработки, должны проверять подлинность цифровой подписи! Цифровая подпись формируется также, как и с запросами на сервер TransUNIQ (пример №2 ), а затем сравнивается с пришедшим на url_quest параметром "sign". При этом logFrom — логин продавца в Uniq-IP, pasFrom — его пароль (таблица)