Crediti / Wallet

Endpoint in sola lettura (GET) sul saldo crediti dell'utente autenticato. Sono gratuiti (non consumano credito) e già disponibili con il tuo Bearer token — non serve una whitelist di origin configurata.

Auth: header Authorization: Bearer <api_token> su ogni chiamata. Base URL: https://api.dokicasa.it (produzione) · https://api-dev.dokicasa.it (sandbox).

Saldo wallet

GET /api/users/me/wallet

Restituisce il saldo dell'utente, comprensivo dei costi futuri previsti (job schedulati e censimenti pendenti).

{
  "wallet": 120.00,
  "real_wallet": 89.50
}

Campo	Tipo	Note
wallet	number	Saldo nominale attuale sul wallet
real_wallet	number	Saldo realmente disponibile, al netto dei costi già impegnati (pendenti)

Storico transazioni

GET /api/users/me/wallet-transactions

Storico paginato delle movimentazioni del wallet (le più recenti prima).

Query	Default	Note
per_page	20	elementi per pagina
page	1	pagina da leggere

Risposta: paginatore Laravel — { current_page, data: [ … ], per_page, total, last_page, … }.

Prova rapida (curl)

curl https://api-dev.dokicasa.it/api/users/me/wallet \
  -H "Authorization: Bearer HfBfYShns3E02no3kkwCRWQugkVNcJCtrRN2BPoI5NxhqsiXaxxnSPpIHY2O"
# → { "wallet": 120.00, "real_wallet": 89.50 }

TIP

Puoi provarli subito con il token di test sulla sandbox: sono chiamate di sola lettura, gratuite.