1.0.4 • Published 3 years ago
holops v1.0.4
Холоп API
NodeJS библиотека для работы с API сервиса "Холопы"
Установка
npm
npm i holops
Подключение
const {
Holops
} = require('holops')
const hapi = new Holops('Token', 'user_id')
Методы API
getProjectInfo - Получить информацию о Вашем проекте
Пример:
async function run() {
const info = await hapi.getProjectInfo()
console.log(info)
}
run().catch(console.error);
editProjectInfo - Редактировать информацию о Вашем проекте
Параметр | Тип | Обязателен | Описание |
---|---|---|---|
name | string | Нет | Название проекта |
avatar | string | Нет | Прямая ссылка на новый аватар проекта |
group_id | number | Нет | ID группы проекта |
- Все параметры должны быть переданы
Пример:
async function run() {
const info = await hapi.editProjectInfo(
'My app',
'vk.com/images/camera_200.png',
1
);
console.log(info)
};
run().catch(console.error);
getTransactionList - Получает список ваших транзакций
Параметр | Тип | Обязателен | Описание |
---|---|---|---|
tx | Number | нет | Количество переводов (0 - все переводы) |
Пример:
async function run() {
const result = await hapi.getTransactionList(0);
console.log(result); // {pay: true, sum: 12, date: unix, name: 'HYDRA WHEEL', photo: 'vk.com', iduser: 548313221} (Параметр pay означает отправили вы или вам: true - Вы, false - Вам)
}
run().catch(console.error);
getBalance - Получить баланс пользователей
Параметр | Тип | Обязателен | Описание |
---|---|---|---|
userId | Number | да | ID пользователя, чей баланс нужно вернуть |
Пример:
async function run() {
const info = await hapi.getBalance(1);
console.log(info);
};
run().catch(console.error);
sendPayment - Совершить перевод монет указанному пользователю
Параметр | Тип | Обязателен | Описание |
---|---|---|---|
toId | number | да | ID пользователя, которому Вы собираетесь совершить перевод |
amount | number | да | Количество монет, которое Вы собираетесь перевести указанному пользователю |
money | string | да | Индитификатор монеты/багосов |
-- | -- | -- | -- |
Параметр (money) | Описание | ||
-- | -- | -- | -- |
money | монеты | ||
money_new | багосы |
Пример:
async function run() {
const info = await hapi.sendPayment(1, 1, 'money');
console.log(info);
};
run().catch(console.error);
getPaymentLink - Получить ссылку на перевод монет проекту
Пример:
async function run() {
const info = await hapi.getPaymentLink();
console.log(info);
};
run().catch(console.error);
Прослушивание входящих переводов:
Наша библиотека автоматически сверяет hash входящих переводов, защищая Вас от злоумышленников.
Для начала Вам стоит вызвать функцию start
Параметр | Тип | Обязателен | Описание |
---|---|---|---|
path | string\number | да | Ваш IP адрес или домен |
port | number | нет | Прослушиваемый порт |
Затем Вам нужно подписаться на входящие переводы, используя функцию onPayment, в параметры который нужно передать callback функцию.
Пример:
function run() {
hapi.start('http://82.112.51.71', 2096);
hapi.onPayment(context => {
const {
amount,
fromId
} = context;
console.log(context);
});
};
run().catch(console.error);