Nya Funding-slutpunkter – behörighetsändringar från äldre versioner

Krakens nya Funding API förenklar behörighetsmodellen för många slutpunkter. Eftersom samma API-nyckel fungerar för både äldre och nya slutpunkter kräver vissa åtgärder som tidigare krävde flera behörigheter i den äldre versionen nu färre behörigheter i de nya slutpunkterna. Denna artikel förklarar vad som har ändrats och vad du bör vara medveten om.

Vad har ändrats?

I det äldre Funding API:et krävde flera skrivskyddade slutpunkter sammansatta behörigheter. Exempelvis krävdes att både Query Funds och Withdraw Funds var aktiverade på samma nyckel för att se dina uttagsadresser.

I de nya slutpunkterna har alla skrivskyddade funding-slutpunkter konsoliderats under en enda behörighet: Query Funds. Detta gör det enklare att konfigurera nycklar för övervakning och rapportering utan att ge onödig skrivåtkomst.

Det innebär dock också att en befintlig API-nyckel med Query Funds aktiverat kommer att kunna komma åt mer information via de nya slutpunkterna än vad den kunde via de äldre.

Slutpunkter med minskade behörighetskrav

Följande slutpunkter kräver färre behörigheter än sina äldre motsvarigheter:

Nya slutpunkter	Nya behörigheter	Äldre motsvarighet	Äldre behörigheter
listFundingWithdrawals	Query Funds	Hämta status för senaste uttag	Withdraw Funds ELLER Data - Query Ledger Entries
listFundingAddresses	Query Funds	Hämta uttagsadresser	Query Funds OCH Withdraw Funds
getFundingAddresses	Query Funds	Hämta uttagsadresser	Query Funds OCH Withdraw Funds
listFundingMethods	Query Funds	{}	Fråga om medel OCH Insättning
listFundingWithdrawalLimits	Fråga om medel	Hämta uttagsmetoder	Fråga om medel OCH Uttag

Vad detta innebär för dina befintliga API-nycklar

Om du har en API-nyckel som skapades med endast behörigheten Fråga om medel, kan den nyckeln nu komma åt följande information via de nya slutpunkterna som den tidigare inte kunde komma åt via Legacy:

Din lista med uttagsadresser (krävde tidigare även Ta ut medel)
Din uttagshistorik (krävde tidigare Ta ut medel eller Data – Fråga efter huvudboksposter)
Tillgängliga finansieringsmetoder (krävde tidigare även Insättning)
Uttagsgränser och -metoder (krävde tidigare även Insättning)

Varför detta är viktigt

Om du har gett en API-nyckel med endast Fråga om medel-behörighet till en tredjepartstjänst för portföljspårning eller rapportering, kan tjänsten nu hämta ytterligare kontoinformation via det nya API:et, inklusive dina uttagsadresser och uttagshistorik. Även om dessa data är skrivskyddade kan detta innebära mer insyn än du avsåg att dela med dig av.

Slutpunkter med oförändrade behörigheter

Följande nya slutpunkter kräver samma behörigheter som deras Legacy-motsvarigheter:

Slutpunkt	Behörighet	Åtgärd
createFundingWithdrawal	Ta ut medel	Skapa ett uttag till en vitlistad adress
listFundingDepositLimits	Fråga om medel	Visa insättningsgränser
listFundingDeposits	Fråga om medel	Lista insättningar
{}	Hämta medel	Lista tillgängliga finansieringstillgångar
listFundingNetworks	Hämta medel	Lista tillgängliga finansieringsnätverk
calculateFundingFees	Hämta medel	Beräkna avgifter för insättning/uttag

Nya slutpunkter och deras behörigheter

Följande slutpunkter är nya och har ingen motsvarighet i Legacy:

Slutpunkt	Behörighet	Åtgärd
claimFundingDepositAddress	Sätt in	Generera eller anspråka en insättningsadress
generateFundingLightningAddress	Sätt in	Generera en Lightning-insättningsadress/-faktura
listFundingClaimedAddresses	Hämta medel	Lista insättningsadresser
createFundingAddress	{}	Skapa en uttagsadress
deleteFundingAddress	Lägg till uttagsadresser	Radera en uttagsadress

Rekommendationer

Granska dina befintliga API-nycklar

Om du har API-nycklar med Query Funds aktiverat som delas med tredjepartstjänster, bör du granska om du är bekväm med att dessa tjänster har tillgång till ytterligare skrivskyddad data via de nya slutpunkterna.

Tillämpa principen om minsta behörighet

När du skapar nya API-nycklar, aktivera endast de behörigheter som din applikation behöver. Den förenklade behörighetsmodellen gör det enklare att bevilja skrivskyddad åtkomst utan att även bevilja skrivåtkomst.

Använd ytterligare säkerhetskontroller

För alla API-nycklar, särskilt de med utökade behörigheter, bör du överväga att aktivera:

Tvåfaktorsautentisering (2FA) för API-nycklar för att kräva en 2FA-kod vid varje API-anrop