Noi puncte finale de finanțare – Modificări ale permisiunilor din versiunea anterioară

Noul API de finanțare Kraken simplifică modelul de permisiuni pentru multe puncte finale. Deoarece aceeași cheie API funcționează atât pentru versiunea anterioară, cât și pentru noile puncte finale, unele operațiuni care anterior necesitau permisiuni multiple în versiunea anterioară necesită acum mai puține permisiuni în noile puncte finale. Acest articol explică ce s-a schimbat și de ce ar trebui să ții cont.

Ce s-a schimbat?

În API-ul de finanțare din versiunea anterioară, mai multe puncte finale doar în citire necesitau permisiuni compuse. De exemplu, vizualizarea adreselor tale de retragere necesita activarea atât a permisiunilor Query Funds, cât și Withdraw Funds pe aceeași cheie.

În noile puncte finale, toate punctele finale de finanțare doar în citire au fost consolidate sub o singură permisiune Query Funds. Acest lucru facilitează configurarea cheilor pentru monitorizare și raportare, fără a acorda acces de scriere inutil.

Totuși, acest lucru înseamnă și că o cheie API existentă, cu permisiunea Query Funds activată, va putea accesa mai multe informații prin noile puncte finale decât ar fi putut prin punctele finale din versiunea anterioară.

Puncte finale cu cerințe de permisiuni reduse

Următoarele puncte finale necesită mai puține permisiuni decât echivalentele lor din versiunea anterioară:

Puncte finale noi	Permisiuni noi	Echivalent din versiunea anterioară	Permisiuni din versiunea anterioară
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	Get Deposit Methods	Query Funds ȘI Deposit
listFundingWithdrawalLimits	Query Funds	Get Withdrawal Methods	Query Funds ȘI Withdraw

Ce înseamnă asta pentru cheile tale API existente

Dacă ai o cheie API care a fost creată doar cu permisiunea Query Funds, acea cheie poate accesa acum următoarele informații prin noile endpoint-uri, pe care anterior nu le putea accesa prin Legacy:

Lista ta de adrese de retragere (anterior necesita și Withdraw Funds)
Istoricul tău de retrageri (anterior necesita Withdraw Funds sau Data - Query Ledger Entries)
Metode de finanțare disponibile (anterior necesita și Deposit)
Limite și metode de retragere (anterior necesita și Deposit)

De ce este important acest lucru

Dacă ai acordat o cheie doar cu permisiunea Query Funds unui serviciu terț pentru urmărirea sau raportarea portofoliului, acel serviciu poate recupera acum informații suplimentare despre cont prin noul API, inclusiv adresele tale de retragere și istoricul de retrageri. Deși aceste date sunt doar pentru citire, acest lucru poate oferi mai multă vizibilitate decât intenționai să partajezi.

Endpoint-uri cu permisiuni nemodificate

Următoarele endpoint-uri noi necesită aceleași permisiuni ca și echivalentele lor Legacy:

Endpoint	Permission	Operation
createFundingWithdrawal	Withdraw Funds	Creează o retragere către o adresă din lista albă
listFundingDepositLimits	Query Funds	Vezi limitele de depunere
listFundingDeposits	Query Funds	Listează depunerile
listFundingAssets	Interogare Fonduri	Listează activele de finanțare disponibile
listFundingNetworks	Interogare Fonduri	Listează rețelele de finanțare disponibile
calculateFundingFees	Interogare Fonduri	Calculează comisioanele de depunere/retragere

Endpoint-uri noi și permisiunile lor

Următoarele endpoint-uri sunt noi și nu au un echivalent Legacy:

Endpoint	Permisiune	Operațiune
claimFundingDepositAddress	Depune	Generează sau revendică o adresă de depunere
generateFundingLightningAddress	Depune	Generează o adresă/factură de depunere Lightning
listFundingClaimedAddresses	Interogare Fonduri	Listează adresele de depunere
createFundingAddress	Adaugă adrese de retragere	Creează o adresă de retragere
deleteFundingAddress	Adaugă adrese de retragere	Șterge o adresă de retragere

Recomandări

Revizuiește-ți cheile API existente

Dacă ai chei API cu Query Funds activate, care sunt partajate cu servicii terțe, revizuiește dacă ești confortabil cu acele servicii care accesează date suplimentare doar în citire prin noile endpoint-uri.

Aplică principiul celui mai mic privilegiu

Atunci când creezi chei API noi, activează doar permisiunile de care aplicația ta are nevoie. Modelul simplificat de permisiuni facilitează acordarea accesului doar în citire fără a acorda și acces de scriere.

Utilizează controale suplimentare de securitate

Pentru orice cheie API, mai ales cele cu permisiuni extinse, ia în considerare activarea:

Autentificarea cu doi factori (2FA) pentru cheile API pentru a solicita un cod 2FA la fiecare apel API