额度卡预算接口
获取额度卡预算列表
URL: GET /credit/budget/list?page=1
Query:
| 字段 | 必填 | 说明 |
|---|---|---|
| page | 否 | 页码,从1开始 |
| size | 否 | 每页大小 |
| search | 否 | 搜索关键词 |
| status | 否 | 状态 |
| user_id | 否 | 用户ID |
输出: list<CreditBudget>
CreditBudget
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | id |
| user_id | string | 用户id |
| username | string | 用户名 |
| company_name | string | 公司名称 |
| person_name | string | 个人名称 |
| title | string | 名称 |
| amount | number | 预算金额, 单位元 |
| status | string | 状态, NORMAL正常, SUSPENDED已停用 |
| total_consume | number | 累计消费, 单位元 |
| total_consume_count | number | 累计消费笔数 |
| card_count | number | 关联卡数量 |
| created_at | string | 创建时间 |
| updated_at | string | 更新时间 |
新增预算
URL: POST /credit/budget/create
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户id |
| title | string | 是 | 名称 |
| amount | number | 是 | 预算金额 所有金额都是整数且精确到分,如1850,表示18.5元 |
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 预算id |
更新预算
URL: POST /credit/budget/{budget_id}/update
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| title | string | 是 | 名称 |
输出: 无
预算充值
注意: 当前仅支持从钱包充值
URL: POST /credit/budget/{budget_id}/recharge
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| amount | number | 是 | 充值金额 所有金额都是整数且精确到分,如1850,表示18.5元 |
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| budget_amount | number | 预算新金额, 单位元 |
| wallet_balance | number | 钱包新余额, 单位元 |
预算转出
注意: 当前仅支持转出到钱包
URL: POST /credit/budget/{budget_id}/transfer_out
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| amount | number | 是 | 转出金额 所有金额都是整数且精确到分,如1850,表示18.5元 |
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| budget_amount | number | 预算新金额, 单位元 |
| wallet_balance | number | 钱包新余额, 单位元 |
修改预算状态
URL: POST /credit/budget/{budget_id}/change_status
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | string | 是 | 状态, NORMAL正常, SUSPENDED已停用 |
输出: 无
删除预算
URL: POST /credit/budget/{budget_id}/delete
输入: 无
输出: 无