# spk_api

> spk_api - API for https://spk.jakksoft.com

Latest version **1.0.5** (published 2021-02-02) · GPL-3.0-or-later license · 0 weekly downloads

## Install

```sh
npm install spk_api
pnpm add spk_api
yarn add spk_api
bun add spk_api
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.5 |
| Published | 2021-02-02 |
| First published | 2021-01-25 |
| Weekly downloads | 0 |
| License | GPL-3.0-or-later |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 52.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Qugalego |
| Maintainers | qugalet |
| Keywords | spk, sp, api |

## Links

- npm: https://www.npmjs.com/package/spk_api
- Repository: https://github.com/Andrmist/spk_api
- Homepage: https://github.com/Andrmist/spk_api#readme
- Issues: https://github.com/Andrmist/spk_api/issues
- npm.io page: https://npm.io/package/spk_api

## Dependencies (1)

- [node-fetch](https://npm.io/package/node-fetch.md) ^2.6.1

## Alternatives

- [@luma.gl/experimental](https://npm.io/package/@luma.gl/experimental.md) — 77.1K weekly downloads
- [persona-harness](https://npm.io/package/persona-harness.md) — 4.7K weekly downloads
- [@tsparticles/effect-bubble](https://npm.io/package/@tsparticles/effect-bubble.md) — 4.6K weekly downloads
- [f3d](https://npm.io/package/f3d.md) — 730 weekly downloads
- [spark-html-motion](https://npm.io/package/spark-html-motion.md) — 298 weekly downloads

## Recent versions

- 1.0.5 (latest) — 2021-02-02
- 1.0.4 — 2021-01-26
- 1.0.3 — 2021-01-26
- 1.0.2 — 2021-01-25
- 1.0.1 — 2021-01-25
- 1.0.0 — 2021-01-25

## README

# spk_api
<p>Модуль создан Qugalego (Andrmist) для серверов SP, SPM, SPK.</p>

### Установка:

```shell
$ npm install spk_api
```

### Пример:

```js 
const SPK = require("spk_api");
const spk = new SPK("token", "response_key", "spk");
(async () => {
    console.log(await spk.test());
})()
```

# API Reference

P.S: deprecated методы будут удалены после обновления API на сайте https://spk.jakksoft.com
## Методы

<dl>
<dt><a href="#run">run</a> ⇒ <code>Object</code></dt>
<dd><p>Прямое обращение к SPK API</p>
</dd>
<dt><a href="#test">test</a> ⇒ <code>Object</code></dt>
<dd><p>Запрос, не выполняющий никаких действий. Создан для настройки и проверки работоспособности API.</p>
</dd>
<dt><a href="#pay">pay</a> ⇒ <code>Object</code></dt>
<dd><p>API, позволяющее производить банковские транзакции. Предназначено для оплаты услуг и товара на Ваших сайтах.
Оплата производится в АР, получателем средств является банковский счёт, указанный в параметрах Вашего приложения
в разделе SP Dev. Комиссии за переводы отсутствуют</p>
</dd>
<dt><a href="#getPermission">getPermission</a> ⇒ <code>Object</code></dt>
<dd><p>При первом запуске Вашего приложения, вы можете сразу рассказать пользователю, какие разрешения вам необходимы
для работоспособности приложения и запросить их все с помощью данного запроса.</p>
Полный список всех разрешений:

* 1 - Тестовое разрешение.
* 2 - Чтение информации о банковских счетах.
* 3 - Чтение уведомлений.
* 4 - Пометка уведомлений прочитанными.
</dd>
<dt><a href="#permissionTest">permissionTest</a> ⇒ <code>Object</code></dt>
<dd><p>Запрос, не выполняющий никаких действий. Создан для проверки работы механизма выдачи прав доступа.</p>
</dd>
<dt><a href="#getCardsInfo">getCardsInfo</a> ⇒ <code>Object</code></dt>
<dd><p>Получение данных о банковских счетах пользователя.</p>
</dd>
<dt><a href="#getUnreadNotifications">getUnreadNotifications</a> ⇒ <code>Object</code></dt>
<dd><p>Получение списка непрочитанных уведомлений.</p>
</dd>
<dt><a href="#markNotificationsAsRead">markNotificationsAsRead</a> ⇒ <code>Object</code></dt>
<dd><p>Пометка всех непрочитанных уведомлений пользователя как &quot;прочитано&quot;.</p>
</dd>
</dl>

<a name="spkAPI"></a>

## spkAPI
**Kind**: global class

* [spkAPI](#spkAPI)
    * [new spkAPI(token, responseKey)](#new_spkAPI_new)
    * [.get_permission()](#spkAPI+get_permission)
    * [.permission_test()](#spkAPI+permission_test)
    * [.get_cards_info()](#spkAPI+get_cards_info)
    * [.get_unread_notifications()](#spkAPI+get_unread_notifications)
    * [.mark_notifications_as_read()](#spkAPI+mark_notifications_as_read)

<a name="new_spkAPI_new"></a>

### new spkAPI(token, responseKey)
Модуль создан Qugalego (Andrmist) для серверов SP, SPM, SPK.


| Param | Type | Default | Description |
| --- | --- | --- | --- |
| token | <code>String</code> |  | Секретный TOKEN вашего приложения. |
| responseKey | <code>String</code> |  | Ключ ответа. Используется для проверки подлинности источника серверного ответа. |
| server | <code>String</code> | <code>spk</code> | Сервер на котором вы хотите использовать API. "sp", "spm" или "spk" |

<a name="spkAPI+get_permission"></a>

### ~~spkAPI.get\_permission()~~
***Deprecated***

Тоже самое, что и [getPermission](#getPermission)

**Kind**: instance method of [<code>spkAPI</code>](#spkAPI)  
<a name="spkAPI+permission_test"></a>

### ~~spkAPI.permission\_test()~~
***Deprecated***

Тоже самое, что и [permissionTest](#permissionTest)

**Kind**: instance method of [<code>spkAPI</code>](#spkAPI)  
<a name="spkAPI+get_cards_info"></a>

### ~~spkAPI.get\_cards\_info()~~
***Deprecated***

Тоже самое, что и [getCardsInfo](#getCardsInfo)

**Kind**: instance method of [<code>spkAPI</code>](#spkAPI)  
<a name="spkAPI+get_unread_notifications"></a>

### ~~spkAPI.get\_unread\_notifications()~~
***Deprecated***

Тоже самое, что и [getUnreadNotifications](#getUnreadNotifications)

**Kind**: instance method of [<code>spkAPI</code>](#spkAPI)  
<a name="spkAPI+mark_notifications_as_read"></a>

### ~~spkAPI.mark\_notifications\_as\_read()~~
***Deprecated***

Тоже самое, что и [markNotificationsAsRead](#markNotificationsAsRead)

**Kind**: instance method of [<code>spkAPI</code>](#spkAPI)  
<a name="run"></a>

## run ⇒ <code>Object</code>
Прямое обращение к SPK API

**Kind**: global variable

| Param | Type | Description |
| --- | --- | --- |
| data | <code>Object</code> | что передать на сервер |

<a name="test"></a>

## test ⇒ <code>Object</code>
Запрос, не выполняющий никаких действий. Создан для настройки и проверки работоспособности API.

**Kind**: global variable  
<a name="pay"></a>

## pay ⇒ <code>Object</code>
API, позволяющее производить банковские транзакции. Предназначено для оплаты услуг и товара на Ваших сайтах.
Оплата производится в АР, получателем средств является банковский счёт, указанный в параметрах Вашего приложения
в разделе SP Dev. Комиссии за переводы отсутствуют

**Kind**: global variable

| Param | Type | Description |
| --- | --- | --- |
| spPayCode | <code>String</code> | Временный код, полученный в кошельке на этом сайте. |
| sum | <code>String</code> \| <code>Number</code> | Сумма АР которая будет снята. |
| transactionMessage | <code>String</code> | Описание транзакции. |

<a name="getPermission"></a>

## getPermission ⇒ <code>Object</code>
При первом запуске Вашего приложения, вы можете сразу рассказать пользователю, какие разрешения вам необходимы
для работоспособности приложения и запросить их все с помощью данного запроса.
Полный список всех разрешений:
* 1 - Тестовое разрешение.
* 2 - Чтение информации о банковских счетах.
* 3 - Чтение уведомлений.
* 4 - Пометка уведомлений прочитанными.

**Kind**: global variable

| Param | Type | Description |
| --- | --- | --- |
| license_key | <code>String</code> | Ключ лицензии пользователя, у которого запрашивается разрешение. |
| permission_id | <code>String</code> \| <code>Number</code> | ID запрашиваемого разрешения. |

<a name="permissionTest"></a>

## permissionTest ⇒ <code>Object</code>
Запрос, не выполняющий никаких действий. Создан для проверки работы механизма выдачи прав доступа.

**Kind**: global variable

| Param | Type | Description |
| --- | --- | --- |
| license_key | <code>String</code> | Ключ лицензии пользователя, у которого запрашивается разрешение. |

<a name="getCardsInfo"></a>

## getCardsInfo ⇒ <code>Object</code>
Получение данных о банковских счетах пользователя.

**Kind**: global variable

| Param | Type | Description |
| --- | --- | --- |
| license_key | <code>String</code> | Ключ лицензии пользователя, у которого запрашивается разрешение. |

<a name="getUnreadNotifications"></a>

## getUnreadNotifications ⇒ <code>Object</code>
Получение списка непрочитанных уведомлений.

**Kind**: global variable

| Param | Type | Description |
| --- | --- | --- |
| license_key | <code>String</code> | Ключ лицензии пользователя, у которого запрашивается разрешение. |

<a name="markNotificationsAsRead"></a>

## markNotificationsAsRead ⇒ <code>Object</code>
Пометка всех непрочитанных уведомлений пользователя как "прочитано".

**Kind**: global variable

| Param | Type | Description |
| --- | --- | --- |
| license_key | <code>String</code> | Ключ лицензии пользователя, у которого запрашивается разрешение. |

---
_Source: https://npm.io/package/spk_api · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._