A nova Funding API da Kraken simplifica o modelo de permissões para muitos endpoints. Como a mesma API key funciona tanto no Legacy como nos novos endpoints, algumas operações que anteriormente exigiam múltiplas permissões no Legacy agora exigem menos permissões nos novos endpoints. Este artigo explica o que mudou e do que você deve estar ciente.
Na Legacy Funding API, vários endpoints apenas de leitura exigiam permissões compostas. Por exemplo, visualizar os seus endereços de levantamento exigia que tanto Query Funds como Withdraw Funds estivessem ativadas na mesma chave.
Nos novos endpoints, todos os endpoints de financiamento apenas de leitura foram consolidados sob uma única permissão Query Funds. Isso facilita a configuração de chaves para monitorização e relatórios sem conceder acesso de escrita desnecessário.
No entanto, isto também significa que uma API key existente com Query Funds ativada será capaz de aceder a mais informações através dos novos endpoints do que conseguia através dos endpoints legados.
Os seguintes endpoints exigem menos permissões do que os seus equivalentes Legados:
Novos Endpoints | Novas Permissões | Equivalente Legado | Permissões Legado |
|---|---|---|---|
| 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 E Depositar |
| listFundingWithdrawalLimits | Query Funds | Obter Métodos de Levantamento | Query Funds E Levantar |
Se tiver uma chave API que foi criada apenas com a permissão Query Funds, essa chave pode agora aceder à seguinte informação através dos novos endpoints que anteriormente não conseguia aceder através do Legacy:
A sua lista de endereços de levantamento (anteriormente também exigia Withdraw Funds)
O seu histórico de levantamentos (anteriormente exigia Withdraw Funds ou Data - Query Ledger Entries)
Métodos de financiamento disponíveis (anteriormente também exigia Deposit)
Limites e métodos de levantamento (anteriormente também exigia Deposit)
Se concedeu uma chave apenas para Query Funds a um serviço de terceiros para controlo ou relatórios de portefólio, esse serviço pode agora recuperar informações adicionais da conta através da nova API, incluindo os seus endereços de levantamento e histórico de levantamentos. Embora estes dados sejam apenas de leitura, isto pode representar mais visibilidade do que pretendia partilhar.
Os seguintes novos endpoints exigem as mesmas permissões que os seus equivalentes Legacy:
Endpoint | Permissão | Operação |
|---|---|---|
| createFundingWithdrawal | Withdraw Funds | Criar um levantamento para um endereço na lista de permissões |
| listFundingDepositLimits | Query Funds | Ver limites de depósito |
| listFundingDeposits | Query Funds | Listar depósitos |
| listFundingAssets | Query Funds | Listar ativos de financiamento disponíveis |
| listFundingNetworks | Consultar Fundos | Listar redes de financiamento disponíveis |
| calculateFundingFees | Consultar Fundos | Calcular taxas de depósito/levantamento |
Os seguintes endpoints são novos e não têm equivalente Legacy:
Endpoint | Permissão | Operação |
|---|---|---|
| claimFundingDepositAddress | Depositar | Gerar ou reivindicar um endereço de depósito |
| generateFundingLightningAddress | Depositar | Gerar um endereço/fatura de depósito Lightning |
| listFundingClaimedAddresses | Consultar Fundos | Listar endereços de depósito |
| createFundingAddress | Adicionar Endereços de Levantamento | Criar um endereço de levantamento |
| deleteFundingAddress | Adicionar Endereços de Levantamento | Eliminar um endereço de levantamento |
Rever as suas chaves API existentes
Se tiver chaves API com Consulta de Fundos ativada que são partilhadas com serviços de terceiros, reveja se se sente confortável com esses serviços a acederem a dados adicionais apenas de leitura através dos novos pontos de extremidade.
Aplique o princípio do menor privilégio
Ao criar novas chaves API, apenas ative as permissões de que a sua aplicação precisa. O modelo de permissões simplificado facilita a concessão de acesso apenas de leitura sem também conceder acesso de escrita.
Utilize controlos de segurança adicionais
Para qualquer chave API, especialmente as com permissões elevadas, considere ativar:
Autenticação de dois fatores (2FA) para chaves API para exigir um código 2FA em cada chamada API