Новий Funding API від Kraken спрощує модель дозволів для багатьох кінцевих точок. Оскільки один і той самий API-ключ працює як із Legacy, так і з новими кінцевими точками, деякі операції, які раніше потребували кількох дозволів у Legacy, тепер потребують менше дозволів у нових кінцевих точках. У цій статті пояснюється, що змінилося і про що вам слід знати.
У Legacy Funding API кілька кінцевих точок тільки для читання (read-only) потребували складних дозволів. Наприклад, для перегляду ваших адрес для виведення коштів потрібно було, щоб на одному ключі були ввімкнені одночасно Query Funds та Withdraw Funds.
У нових кінцевих точках усі кінцеві точки фінансування тільки для читання було об’єднано під одним дозволом Query Funds. Це спрощує налаштування ключів для моніторингу та звітності без надання непотрібного доступу на запис.
Однак це також означає, що існуючий API-ключ з увімкненим дозволом Query Funds зможе отримувати доступ до більшої кількості інформації через нові кінцеві точки, ніж через Legacy-кінцеві точки.
Для наведених нижче кінцевих точок потрібно менше дозволів, ніж для їхніх еквівалентів у Legacy:
Нові кінцеві точки | Нові дозволи | Еквівалент Legacy | Дозволи Legacy |
|---|---|---|---|
| listFundingWithdrawals | Query Funds | Отримання статусу останніх виведень коштів | Withdraw Funds АБО Data - Query Ledger Entries |
| listFundingAddresses | Query Funds | Отримання адрес для виведення коштів | Query Funds ТА Withdraw Funds |
| getFundingAddresses | Query Funds | Отримання адрес для виведення коштів | Query Funds ТА Withdraw Funds |
| listFundingMethods | Query Funds | {} | Запит коштів ТА Депозит |
| listFundingWithdrawalLimits | Запит коштів | Отримання методів виведення | Запит коштів ТА Виведення |
Якщо у вас є API-ключ, створений лише з дозволом Запит коштів, цей ключ тепер може отримати доступ до такої інформації через нові ендпоінти, до якої раніше він не міг отримати доступ через Legacy:
Ваш список адрес для виведення (раніше також вимагав Виведення коштів)
Ваша історія виведення (раніше вимагала Виведення коштів або Дані - Запит записів у книзі)
Доступні методи фінансування (раніше також вимагали Депозит)
Ліміти та методи виведення (раніше також вимагали Депозит)
Якщо ви надали ключ лише з дозволом Запит коштів сторонньому сервісу для відстеження портфеля або звітності, цей сервіс тепер може отримувати додаткову інформацію про акаунт через новий API, включаючи ваші адреси для виведення та історію виведення. Хоча ці дані доступні лише для читання, це може бути більший рівень видимості, ніж ви планували надати.
Наступні нові ендпоінти вимагають тих самих дозволів, що й їхні аналоги в Legacy:
Ендпоінт | Дозвіл | Операція |
|---|---|---|
| createFundingWithdrawal | Виведення коштів | Створення виведення на адресу з білого списку |
| listFundingDepositLimits | Запит коштів | Перегляд лімітів депозиту |
| listFundingDeposits | Запит коштів | Список депозитів |
| listFundingAssets | {} | Перелік доступних активів для фінансування |
| listFundingNetworks | Запит щодо коштів | Перелік доступних мереж для фінансування |
| calculateFundingFees | Запит щодо коштів | Розрахунок комісій за депозит/виведення |
Наведені нижче ендпоінти є новими і не мають аналогів у Legacy:
Ендпоінт | Дозвіл | Операція |
|---|---|---|
| claimFundingDepositAddress | Внести | Створення або отримання адреси для депозиту |
| generateFundingLightningAddress | Внести | Створення адреси/рахунку для депозиту Lightning |
| listFundingClaimedAddresses | Запит щодо коштів | Список адрес для депозиту |
| createFundingAddress | Додавання адрес для виведення | Створення адреси для виведення |
| It appears that the JSON payload you intended to translate was not included in your message. Please provide the JSON object, and I will translate it according to the specified instructions. | Додати адреси для виведення коштів | Видалити адресу для виведення коштів |
Перевірте наявні API-ключі
Якщо у вас є API-ключі з увімкненим дозволом Query Funds, які надані стороннім сервісам, перевірте, чи прийнятно для вас, щоб ці сервіси отримували доступ до додаткових даних у режимі «тільки для читання» через нові кінцеві точки (endpoints).
Застосовуйте принцип найменших привілеїв
Під час створення нових API-ключів вмикайте лише ті дозволи, які потрібні вашому додатку. Спрощена модель дозволів полегшує надання доступу в режимі «тільки для читання» без надання прав на запис.
Використовуйте додаткові засоби безпеки
Для будь-якого API-ключа, особливо з підвищеними привілеями, варто увімкнути:
Двофакторну автентифікацію (2FA) для API-ключів, щоб вимагати код 2FA для кожного виклику API