跳转到内容
tansr 资料站

余额与近账(balance/currency 恒 CNY 锚;balances 分币种余额 + recent 行级 currency;warnLowBalance/lowBalanceThreshold 低余额警示:阈值 TANSR_API_LOW_BALANCE_WARN 可配、与 /t1 t.warn balance_low 同源;recent 固定 20 行(上限常量单点);带 x-tansr-org 头 = org 台账,账务面 owner/billing)

GET
/v1/credits
curl --request GET \
  --url https://api.tansr.com/v1/credits \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Header Parameters

Section titled “Header Parameters”
x-tansr-org
string

Org 作用域声明(org 公开 id);服务端校验成员资格与角色,非成员恒 404、角色不够 403

Responses

Section titled “Responses”

200

Section titled “200”

余额

Media typeapplication/json
object
ownerType
required
string
ownerId
required
string
balance
required

CNY 余额(DECIMAL 字符串;存量锚,多币全景见 balances)

string
currency
required

恒 ‘CNY’(balance 字段的币种锚)

string
balances
required

分币种余额(T-A26 加法;恒含 CNY 行,币种字典序)

Array<object>
object
currency
required

记账币种(CNY/USD;恒不折算恒不跨币加总)

string
balance
required

该币种台账终审余额,DECIMAL 字符串

string
warnLowBalance
required

低余额警示位(K8a 加法:balance(CNY 锚)低于 lowBalanceThreshold;与 /t1 t.warn balance_low 同阈值单点)

boolean
lowBalanceThreshold
required

低余额警示阈(CNY DECIMAL 字符串;TANSR_API_LOW_BALANCE_WARN,缺省 ‘1.000000’;console 横幅端侧兜底对齐此值)

string
recent
required
Array<object>
object
delta
required
string
balanceAfter
required

该笔所在币种链的行后余额(T-A26:balance_after 按币种分链)

string
currency
required

该笔记账币种(T-A26 加法)

string
reason
required
string
refType
required
string
refId
required
string
createdAt
required
string
Examplegenerated
{
  "ownerType": "example",
  "ownerId": "example",
  "balance": "example",
  "currency": "example",
  "balances": [
    {
      "currency": "example",
      "balance": "example"
    }
  ],
  "warnLowBalance": true,
  "lowBalanceThreshold": "example",
  "recent": [
    {
      "delta": "example",
      "balanceAfter": "example",
      "currency": "example",
      "reason": "example",
      "refType": "example",
      "refId": "example",
      "createdAt": "example"
    }
  ]
}