Universe Escrow

Escrow предоставляет API-интерфейс для доступа к различной информации сервиса.

Запросы возвращают JSON-ответ, пример:


{
    "status": "success", 
    "data": [ ], 
    "error": ""
}
где status - статус ответа (error или sucess);
data - массив с данными ответа;
error - текст ошибки, если она появилась во время запроса.


Для выполнения некоторых запросов требуется API ключ, который можно найти в личном кабинете, и авторизация.
Сначала выполняется авторизация пользователя через /api/auth_user.php, затем авторизация api_key через /api/auth_api.php, после чего можно выполнять запросы.
Ниже показаны примеры авторизации.


1. Авторизация пользователя


2. Авторизация api_key

Данный запрос необходим для авторизации вашего API-ключа, чтобы выполнять некоторые другие запросы (см. ниже).
Запрос должен выполнять после авторизации пользователя.

где uid - ваш User ID.

3. Получение данных о пользователе (себе)

Перед данным запросом требуется авторизация.


4. Запрос рейтинга произвольного пользователя

где UR - User Rating - средний рейтинг пользователя по 5 бальноый шкале с округлением до сотых;
deals - всего завершенных сделок (успешных и с возвратом);
done - количество сделок завершенных успешно;
volume - суммарный объем сделок в UNI;


5. Получение данных о предложении

где created - дата создания предложения (UTC +0);
edited - дата изменения (UTC +0);
active - активно ли предложение (можно ли сейчас по нему создать сделку), значения '0' и '1';
closed - было ли предложение закрыто (после закрытия по нему нельзя открывать сделки), значения '0' и '1';
user - псевдоним автора предложения;
title - название предложения (товара или услуги);
direction - направление предложения, значения 'sell' и 'buy';
pcount - product count - количество товара в резерве предложения;
min - минимальный заказ в пределах одной сделки;
units - единицы измерения количества товара;
price - цена за 1 единицу товара;
deliveryMethod - описание метода доставки товара;
deliveryTime - ожидаемое максимальное время доставки в минутах;
extras - дополнительные сведения;


6. Получение данных о сделке

Требуется авторизация и отношение к сделке.

где edi - escrow deal id - идентификатор сделки;
oid - offer id - идентификатор предложения;
status - текущий статус сделки (paid, returned, done, wait, dispute, court);
amount - сумма сделки в UNI;
pcount - product count - количество товара в сделке;
isSent - был ли товар отправлен продавцом, значения '0' и '1';
isReceived - был ли товар получен покупателем, значения '0' и '1';
timeFrom - время заключения сделки (UTC +0);
timeTo - время окончания срока ожидания доставки (UTC +0);
waitTime - время, до которого покупатель может открыть спор, если время ожидания доставки вышло (UTC +0);
disputeTime - время, до которого действует спор, а затем будет передан в арбитраж, если спор не будет решен (UTC +0);


7. Запрос информации о новых событиях

Для этого запроса требуется авторизация. Набор массивов с данными о событиях или пустой массив.

где type - тип события:


7. Получение данных о активных предложениях пользователя

где oid - offer id - id предложения;
created - дата создания предложения (UTC +0);
edited - дата изменения (UTC +0);
closed - было ли предложение закрыто (после закрытия по нему нельзя открывать сделки), значения '0' и '1';
title - название предложения (товара или услуги);
direction - направление предложения, значения 'sell' и 'buy';
pcount - product count - количество товара в резерве предложения;
min - минимальный заказ в пределах одной сделки;
units - единицы измерения количества товара;
price - цена за 1 единицу товара;
deliveryTime - ожидаемое максимальное время доставки в минутах;
im_id - id изображения предложения;
im_seed - код изображения (im_id и im_seed используются для построения ссылки к изображению);
image - url изображения предложения;