Wallet API
Referência do contrato próprio da extensão Wallet.
A Wallet usa a chave da plataforma e opera no workspace da própria chave: uma chave criada no pessoal opera as carteiras pessoais; uma criada numa organização, as dela. Veja a visão da extensão.
Functions e Actions
O contrato tem sete operações, todas em /v1/wallet: é o protocolo do
módulo, e ele é a superfície inteira. Functions são as treze leituras
(wallet.portfolio.get, wallet.consolidated.get, wallet.portfolio.xray,
wallet.suitability.get…) e Actions são as onze escritas
(wallet.portfolio.create, wallet.transaction.create…). Cada capacidade
carrega o próprio id, critério de uso e schemas, e você a descobre pelo
catálogo: GET /v1/wallet/functions e GET /v1/wallet/actions.
Para executar uma Function, a carteira entra em subject.entity_id (ou
subject.resolve, com o nome) e os parâmetros em input, conforme o
input_schema que GET /v1/wallet/functions/{id} devolve. Toda escrita aceita
preview antes de execute, e as destrutivas exigem confirmed: true.
As rotas especializadas /v1/portfolios/*, /v1/portfolio e /v1/suitability
saíram do contrato: cada uma tinha uma Function ou Action que faz o mesmo, pelo
mesmo serviço. A tabela de equivalência está na
visão da extensão.
APIs das extensões
Contratos separados para capacidades instaláveis do DataBolsa.
Executa uma Function
Executa a Function no sujeito informado (`entity_id` do recurso) com o `input` do spec. `at` aplica o corte temporal no campo que o spec declara. Recusas trazem `details.code`: `subject_required`, `subject_not_found`, `temporal_cut_unsupported`, `invalid_input`, `scope_missing`.