Комиссия при продаже на NVSPC составляет:
+ 1% (у лучших продавцов)
+ 2% (у обычных продавцов)
NVSPC готов отдавать половину этих комиссий проектам-конкурентам. Рабочий пример на JavaScript можно увидеть на NVSPC витрине, подгружающей данные по AJAX:
• получение ассортимента (пример: http://nvspc.i2p/api/dummy/getShowcase )
• покупка (пример: http://nvspc.i2p/api/dummy/Buy )
В данных примерах запросы к API указанны с ключом-пустышкой "Dummy". Данный ключ позволяет получать данные любому пользователю API в JSON формате. По всем вопросам обращаться к #2. В идеале схема выглядит так: У Вас есть аккаунт на NVSPC c ID:#XXX. На витрине NVSPC у продавца #345 есть лот: "QIWI Ваучер 10000р", 1шт за 10500р Пользователь вашего сайта например id456Vasya видит на витрине вашего проекта лоты, среди которых есть "QIWI Ваучер 10000р", 1шт за 11025р от продавца id678Robo(Ваш аккаунт на Вашем проекте).
• id456Vasya пополняет свой баланс у Вас на проекте на 11025р
• покупает этот лот и получает его в свою корзину на Вашем сайте
• Ваш id456Vasya доволен покупкой
• наш #345 доволен продажей
Это всего-лишь видимая верхушка айсберга. на самом деле происходит следующее:
(вы установили наценку 5%) пользователь вашего сайта например id456Vasya видит на витрине вашего проекта лоты, среди которых есть "QIWI Ваучер 10000р", 1шт за 11025р" от продавца id678Robo
• пользователь вашего сайта, например id456Vasya, видит на витрине вашего проекта лоты, среди которых есть "QIWI Ваучер 10000р", 1шт за 11025р" от продавца id678Robo
• id456Vasya пополняет свой баланс на 11025р и покупает этот лот у Вас на проекте
• Ваш проект обращается на NVSPC от имени #XXX и делает покупку "QIWI Ваучер 10000р", 1шт за 10500р" у #345 от имени #XXX
• Ваш проект отправляет этот лот Вашему пользователю id456Vasya в корзину
• Ваш id456Vasya доволен покупкой
• наш #345 доволен продажей
После этой "сквозной покупки" на баланс #XXX падает Вознаграждение:
• 1% * 10500р. = 105р. (итого Ваша прибыль составляет 625р или почти 6% от суммы сделки)
После каждой продажи Ваш проект переводит Сумму покупки за вычетом Вознаграждения на наш актуальный кошелёк, с комментом #XXX, чтобы можно было повторить схему для следующей "сквозной покупки".
Обращение к API производится с помощью POST/GET запроса на следующие адреса:
"nvКЛЮЧ" - это API-ключ, который генерируется в разделе #настройки на проекте NVSPC. МЕТОДЫ /api/nvКЛЮЧ - проверка подключения и проверка ключа на валидность. Примеры ответа:
• Верный ключ - {"ok":1,"data":{"r":"Ok"}}
• Неверный ключ - {"ok":0,"data":{"r":"Unauthorized"}}
Ответ в виде JSON-объекта, в котором всегда будет поле ok.
Если поле ok = 1, то запрос прошёл успешно и результат его выполнения можно увидеть в поле data.
В случае ошибки поле ok будет равно 0, а причины ошибки будут описаны в поле data:r
/api/dummy/getCurrs - максимальная предложенная цена на покупку во всех парах
Пример ответа:
{
"ok":1,
"data":{
"btcrur":285000.0,
"gstbtc":0.000082,
"gstrur":25.0
}
}
/api/dummy/getStockGlass?t=1&c=15 - вывод ближайших к текущей цене заявок
Обязательные параметры:
t - Биржа (1=BTCRUR 2=GSTRUR 3=GSTBTC 7=BCHRUR)
c - Количество выводимых заявок
Пример ответа:
{
"ok":1,
"data":{
"Sell":[
{"cost":313595.999,"amount":0.00559056},
{"cost":313593.99,"amount":0.0073438907423},
{"cost":313591.999,"amount":0.0374365843204}],
"Buy":[
{"cost":293002.1,"amount":0.0038077015842},
{"cost":293002.0,"amount":0.0034129459868},
{"cost":293001.0,"amount":0.0062900809212}]
}
}
/api/nvКЛЮЧ/getShowcase - ассортимент(витрина)
Необязательные параметры:
c - Уникальный идентификатор определённого города; 22 символа
u - Уникальный идентификатор продавца; 1-5 символов
Пример ответа:
{
"ok": 1, // (bit) Результат выполнения запроса
//
"data": {
"Lots":[{ // [] массив лотов на витрине
"LNID":"juY5L5Do_0KL9QXYkYMpOg", // (string) Уникальный идентификатор названия лота; 22 символа //LotNameidentificator
"CID":"co45x8V4gEaZPDXBBs1x_A", // (string) Уникальный идентификатор города; 22 символа //CityIDentificator
"Ds":[{ // [] массив районов
"C":[ // [] массив цен и количеств
{"W":0.7,"C":1855.0,"A":0},// вес, цена, валюта(0=рубли 1=bitcoin)
...],
"id":"J1rzsgE5wk2CjwmgPITY7A","N":"Авиагородок"},// id района и его наименование
{"C":[{"W":1.5,"C":3600.0,"A":0}],"id":"t8m9DHB-HE6RCpxjOPHbaA","N":"Центр"},
...],
"UID":"2ZMQ" // (string) Уникальный идентификатор продавца; [1-5] символов
},
...],
"LN":[{ // [] Массив наименований лотов
"id":"juY5L5Do_0KL9QXYkYMpOg", // (string) Уникальный идентификатор названия лота; 22 символа //identificator
"UID":"2ZMQ", // (string) Уникальный идентификатор продавца; [1-5] символов //Seller_IDentificator
"Name":"СИМ-карты", // (string) Название лота; до 50 символов //
"IMGid":"f4Ybur4srEmFa6JZ5tWSDg", // (string) Уникальный идентификатор главного изображения названия лота (22 символа)
"T":70, // (int) Тип товара
"sT":40, // (int) Подтип товара
"xR":683.34}, // (decimal) Рейтинг продавца на витрине. больше - лучше.
...], //
"Users":[{ // [массив] Массив продавцов, представленных на витрине указанного города(или всех городов)
"id":"2ZMQ", // (string) Уникальный идентификатор продавца; [1-5] символов //
"nick":"MARS", // (string) Ник продавца; не больше 30 символов //Seller_Nick
"isModer":0, // (bit) Продавец является модератором?
"isBest":0, // (bit) Продавец является доверенным продавцом ресурса? (доверенный = Входит в топ 10% лучших по стате и обороту)
"css":87.25, // (decimal) Средняя статистика продавца значение [0..100] //
"css90":95.28,"css30":95,"css7":90,"css3":85.81},// (decimal) статистика продавца за 90, 30, 7, 3 суток // значение [0..100] //
...],
"Cities":[{"id":"co45x8V4gEaZPDXBBs1x_A","N":" Москва"}] // идентификаторы и названия городов витрины
}
}
/api/nvКЛЮЧ/getLotName - подробности о Названии лота
Обязательные параметры:
i - Уникальный идентификатор Названия
Пример ответа:
{
"ok":1, // (bit) Результат выполнения запроса
"data":{ // (LotName) Элемент типа LotName
"UID":"47", // (string) Уникальный идентификатор пользователя, создавший Название //UserIDentificator
"S_N":"InvisibleMan", // (string) Ник продавца; не больше 30 символов //Seller_Name
"N":"Название статьи", // (string) Название //LotName
"T":70, // (int) Тип //Type
/// 0 - не указано
/// 10 - Трава(органика)
/// 20 - Экстази
/// 30 - Героин
/// 40 - Кокаин
/// 50 - Амфетамин
/// 60 - ЛСД"sT":20, // (int) Подтип //subType
/// 0 - не указано
/// 10 - седативные (депрессанты)
/// 20 - стимуляторы (uppers)
/// 30 - галлюциногены (trips)
/// 40 - афродизиаки (сексуальные стимуляторы)
"D": // (string) Подробное описание Названия //Description
"[imgL0YEXPx10kWld_5LpFGxpA]\r\n[b]доставка в любой регион РФ, НАШИМ курьером![/b]!", "dt":"01.08.2022 13:21:46" // (string) Дата и время последнего редактирования Названия (в т.ч. описания, типа и подтипа). } } /api/nvКЛЮЧ/getLotnameComments - комментарии Названия лота Обязательные параметры: i - Уникальный идентификатор Названия Необязательные параметры: с - Уникальный идентификатор города. По умолчанию = "" t - Максимальное количество возвращаемых комментариев. По умолчанию 10 Пример ответа: { "ok":1, // (bit) "data":[{ // [Report] "id":"713365", // (string) Уникальный номер комментария "V":1, // (bit) оценка комментария: 1 - положительная "uid":"2TUT", // (string) Уникальный идентификатор пользователя, написавший комментарий "N":"", // (string) Ник пользователя, написавший комментарий "Lid":"Nr2f-QRnUkioDJLtLRdUaw", // (string) Уникальный номер покупки, к которой написан комментарий "Msg":"5+", // (string) Текст самого комментария "dt":"01.08.2022 13:21:46", // (string) дата комментерия "CID":"LpkPX4FIPUSsJV7_tJdFrQ"}, // (string) Уникальный идентификатор города { "id":"713348", "V":1, "uid":"46SB", "N":"", "Lid":"vfD2tdCBokaDindL3WDtiQ", "Msg":"Извини за поздний отзыв, всё на высшем уровне!!!!", "dt":"09.03.2017 04:15:53", "CID":"LpkPX4FIPUSsJV7_tJdFrQ" }, { "id":"713346", // "V":0, // (bit) оценка комментария: 0 - отрицательная "uid":"3YKA", // "N":"", // "Lid":"dgcxJI-560eu2_pqkhzF7g", // "Msg":"не очень", // "dt":"09.03.2017 03:48:15", // "CID":"6Ch2qeCDfUWhLu49unTuJQ" } ... ] } Формат даты/времени: dd.MM.yyyy HH:mm:ss - день.месяц.год час:минуты:секунды /api/nvКЛЮЧ/getUserSellStat - качество продаж конкретного продавца Обязательные параметры: u - Уникальный идентификатор Продавца Пример ответа: { "ok":1, // (bit) "data":{ // (UserSellStat) "s90":99.16, // (decimal) % удачных продаж за 90 суток "s30":97.93, // (decimal) за 30 суток "s7":93.96 // (decimal) за 7 суток } } Остальные методы на данный момент разрабатываются.
References
Visible links . https://nvspc.biz/LS/Dialog/2