Новий Funding API Kraken спрощує модель дозволів для багатьох кінцевих точок. Оскільки той самий API-ключ працює як у Legacy, так і в нових кінцевих точках, деякі операції, що раніше в Legacy потребували кількох дозволів, тепер у нових кінцевих точках вимагають менше дозволів. У цій статті пояснюється, що змінилося і на що слід звернути увагу.
У Legacy Funding API кілька кінцевих точок лише для читання потребували складових дозволів. Наприклад, для перегляду адрес виведення коштів на одному ключі мали бути активовані й Query Funds, і Withdraw Funds.
У нових кінцевих точках усі кінцеві точки поповнення рахунку лише для читання обʼєднано під єдиним дозволом Query Funds. Це спрощує налаштування ключів для моніторингу та звітності без надання зайвого доступу на запис.
Однак це також означає, що наявний API-ключ з увімкненим Query Funds матиме доступ до більшого обсягу інформації через нові кінцеві точки, ніж через кінцеві точки Legacy.
Наведені нижче кінцеві точки потребують менше дозволів, ніж їхні еквіваленти в Legacy:
Нові кінцеві точки | Нові дозволи | Еквівалент у Legacy | Дозволи Legacy |
|---|---|---|---|
| listFundingWithdrawals | Query Funds | Get Status of Recent Withdrawals | Withdraw Funds OR Data - Query Ledger Entries |
| listFundingAddresses | Query Funds | Get Withdrawal Addresses | Query Funds AND Withdraw Funds |
| getFundingAddresses | Query Funds | Get Withdrawal Addresses | Query Funds AND Withdraw Funds |
| listFundingMethods | Query Funds | Отримати методи внесення | Query Funds ТА Deposit |
| listFundingWithdrawalLimits | Query Funds | Отримати методи виведення | Query Funds ТА Withdraw |
Якщо Ваш API-ключ було створено лише з дозволом Query Funds, він тепер може отримувати через нові кінцеві точки таку інформацію, яка раніше була недоступна через Legacy:
Список Ваших адрес виведення коштів (раніше також вимагав дозволу Withdraw Funds)
Історія Ваших виведень (раніше вимагала Withdraw Funds або Data - Query Ledger Entries)
Доступні методи поповнення рахунку (раніше також вимагали Deposit)
Ліміти та методи виведення (раніше також вимагали Deposit)
Якщо Ви надали ключ лише з дозволом Query Funds сторонньому сервісу для відстеження портфеля або формування звітів, цей сервіс тепер може отримувати через новий API додаткову інформацію про обліковий запис, зокрема Ваші адреси виведення коштів та історію виведень. Ці дані доступні лише для читання, проте обсяг інформації, яку побачить сервіс, може бути ширшим, ніж Ви планували.
Наведені нижче нові кінцеві точки вимагають тих самих дозволів, що й їхні аналоги в Legacy:
Кінцева точка | Дозвіл | Операція |
|---|---|---|
| createFundingWithdrawal | Withdraw Funds | Створити виведення на адресу зі списку дозволених |
| listFundingDepositLimits | Query Funds | Переглянути ліміти внесення |
| listFundingDeposits | Query Funds | Перелік внесень |
| listFundingAssets | Query Funds | Перелік доступних активів для поповнення рахунку |
| listFundingNetworks | Query Funds | Перелік доступних мереж для поповнення рахунку |
| calculateFundingFees | Query Funds | Розрахунок комісії за внесення/виведення |
Наведені нижче кінцеві точки є новими та не мають аналогів у Legacy:
Кінцева точка | Дозвіл | Операція |
|---|---|---|
| claimFundingDepositAddress | Внести | Згенерувати або отримати адресу для внесення |
| generateFundingLightningAddress | Внести | Згенерувати адресу/інвойс для Lightning-внесення |
| listFundingClaimedAddresses | Query Funds | Перелік адрес для внесення |
| createFundingAddress | Додати адреси виведення коштів | Створити адресу виведення коштів |
| deleteFundingAddress | Додати адреси виведення коштів | Видалити адресу для виведення коштів |
Перегляньте наявні API-ключі
Якщо у Вас є API-ключі з увімкненим дозволом Query Funds, які надані стороннім сервісам, перевірте, чи прийнятний для Вас доступ цих сервісів до додаткових даних лише для читання через нові кінцеві точки.
Застосовуйте принцип мінімальних привілеїв
Створюючи нові API-ключі, вмикайте лише ті дозволи, які потрібні Вашому застосунку. Спрощена модель дозволів полегшує надання доступу лише для читання без одночасного надання доступу для запису.
Використовуйте додаткові засоби контролю безпеки
Для кожного API-ключа, особливо з підвищеними привілеями, розгляньте можливість увімкнення:
Двофакторна автентифікація (2FA) для API-ключів — вимагає код 2FA під час кожного API-виклику