同步资产给自动记账
# 接口功能
同步资产给自动记账。
注意
发起同步请求前,建议先获取设置(setting_hash_asset)判断数据是否发生变化,避免高频访问接口。 因为自动记账可能处理失败,所以需要以自动记账内部的哈希值为准。
提示
对于自动记账来讲,债务中的借款人、还款人也是资产。
# 请求
POST
http://127.0.0.1:52045/assets/put
# 参数
# body内容
传递给自动记账的是一个Json数组。
[
{
"name":"资产名称",
"icon": "资产图标(Uri或者Base64)",
"currency": "资产币种", // 币种类型参考:https://api.qianjiapp.com/clientweb/currencylist
"extras": "额外数据,属于保留字段",
"type" : "资产类型", // 资产类型参考下面部分
"sort" : 0, //排序
}
]
# 资产类型参考
NORMAL
: 普通资产,例如储蓄卡、借记卡、支付宝、微信、等具有固定余额的账户VIRTUAL
: 虚拟资产,例如积分、优惠券、话费、公交卡余额等需要预先付费(一般不可退回)的账户FINANCIAL
: 理财资产,例如股票、基金、余额宝、余利宝等,存在动态波动(增减)的资产CREDIT
: 信用资产,例如信用卡、蚂蚁花呗,属于小额借贷,有额度限制的账户BORROWER
: 欠款人,例如借款给别人的钱CREDITOR
: 债主,例如别人借钱给自己
# uri参数
名称 | 类型 | 简介 |
---|---|---|
md5 | string | 上面body的md5值 |
# 响应
名称 | 类型 | 简介 |
---|---|---|
code | int | 响应状态,正常为200 |
msg | string | |
data | string |
# 请求示例
POST /category/put?md5=c339d6fe8ec0f01b63f27b829784e797 HTTP/1.1
Host: 127.0.0.1:52045
Content-Type: text/json; charset=UTF-8
[
{
"name":"分类名称",
"icon": "分类图标",
"remoteId" : "123",
"remoteParentId" : "-1",
"remoteBookId" : "123",
"sort" : 0,
},
{
"name":"分类名称",
"icon": "分类图标",
"remoteId" : "1234",
"remoteParentId" : "123",
"remoteBookId" : "123",
"sort" : 0,
},
]
注意
务必要设置Content-Type: text/json; charset=UTF-8
上次更新: 2025/01/02, 12:09:30