Skip to main content

預算接口

創建預算​

POST /abc/v1/budget/create

創建預算

請求頭

名稱類型必填說明範例
X-API-Keystring否-{apiKey}
X-Timestampinteger否-{{Timestamp}}
X-Noncestring否-{{Nonce}}
X-Signaturestring否-{{Signature}}
Content-Typestring否-application/json

請求體

數據模型:OpenBudgetCreateRequest

欄位類型必填說明範例 / 默認值
budgetNamestring是預算名稱研發部門預算
currencystring是幣種USD
budgetLimitnumber是預算金額(單位:分);最小值 0.01100000
subAccountIdstring否子賬戶 IDSUB_001

成功響應

數據模型:CommonResultOpenBudgetResponse

欄位類型必填說明範例 / 默認值
codeinteger否錯誤碼-
msgstring否錯誤提示,用戶可閱讀-
data對象(OpenBudgetResponse)否--

data 結構(OpenBudgetResponse)

欄位類型必填說明範例 / 默認值
budgetIdstring否預算編號-
budgetNamestring否預算名稱-
budgetLimitnumber否預算總額度-
budgetMinLimitnumber否預算最小限額-
spendAmountnumber否已消費金額-
budgetAvailableLimitnumber否預算可用額度-
subAccountIdstring否子賬戶編號-
subAccountNamestring否子賬戶名稱-
currencystring否幣種編碼 ISO 4217USD
budgetStatusinteger否預算狀態:1=正常,2=禁用-
createTimestring否創建時間-
updateTimestring否更新時間-

查詢預算列表​

POST /abc/v1/budget/query

查詢預算列表

請求頭

名稱類型必填說明範例
X-API-Keystring否-{apiKey}
X-Timestampinteger否-{{Timestamp}}
X-Noncestring否-{{Nonce}}
X-Signaturestring否-{{Signature}}
Content-Typestring否-application/json

請求體

數據模型:OpenBudgetQueryRequest

欄位類型必填說明範例 / 默認值
pageNointeger是頁碼,從 1 開始;最小值 11
pageSizeinteger是每頁條數,最大值爲 200;最小值 1;最大值 20010
budgetIdstring否預算編號BUD_20260101_001
budgetNamestring否預算名稱研發部門預算

成功響應

數據模型:CommonResultPageResultOpenBudgetResponse

欄位類型必填說明範例 / 默認值
codeinteger否錯誤碼-
msgstring否錯誤提示,用戶可閱讀-
data對象(PageResultOpenBudgetResponse)否--

data 結構(PageResultOpenBudgetResponse)

欄位類型必填說明範例 / 默認值
totalinteger (int64)否總量-
list數組<對象(OpenBudgetResponse)>否數據-

預算調額​

POST /abc/v1/budget/update

預算調額

請求頭

名稱類型必填說明範例
X-API-Keystring否-{apiKey}
X-Timestampinteger否-{{Timestamp}}
X-Noncestring否-{{Nonce}}
X-Signaturestring否-{{Signature}}
Content-Typestring否-application/json

請求體

數據模型:OpenBudgetIncreaseRequest

欄位類型必填說明範例 / 默認值
budgetIdstring是預算 IDBUD_20260101_001
subAccountIdstring是子賬戶編號SUB_001
budgetLimitnumber是追加金額(單位:分);最小值 0.0150000

成功響應

數據模型:CommonResultOpenBudgetResponse

欄位類型必填說明範例 / 默認值
codeinteger否錯誤碼-
msgstring否錯誤提示,用戶可閱讀-
data對象(OpenBudgetResponse)否--

data 結構(OpenBudgetResponse)

欄位類型必填說明範例 / 默認值
budgetIdstring否預算編號-
budgetNamestring否預算名稱-
budgetLimitnumber否預算總額度-
budgetMinLimitnumber否預算最小限額-
spendAmountnumber否已消費金額-
budgetAvailableLimitnumber否預算可用額度-
subAccountIdstring否子賬戶編號-
subAccountNamestring否子賬戶名稱-
currencystring否幣種編碼 ISO 4217USD
budgetStatusinteger否預算狀態:1=正常,2=禁用-
createTimestring否創建時間-
updateTimestring否更新時間-

預算詳情​

POST /abc/v1/budget/detail

預算詳情

請求頭

名稱類型必填說明範例
X-API-Keystring否-{apiKey}
X-Timestampinteger否-{{Timestamp}}
X-Noncestring否-{{Nonce}}
X-Signaturestring否-{{Signature}}
Content-Typestring否-application/json

請求體

數據模型:OpenBudgetDetailRequest

欄位類型必填說明範例 / 默認值
budgetIdstring是預算編號BUD_20260101_001

成功響應

數據模型:CommonResultOpenBudgetResponse

欄位類型必填說明範例 / 默認值
codeinteger否錯誤碼-
msgstring否錯誤提示,用戶可閱讀-
data對象(OpenBudgetResponse)否--

data 結構(OpenBudgetResponse)

欄位類型必填說明範例 / 默認值
budgetIdstring否預算編號-
budgetNamestring否預算名稱-
budgetLimitnumber否預算總額度-
budgetMinLimitnumber否預算最小限額-
spendAmountnumber否已消費金額-
budgetAvailableLimitnumber否預算可用額度-
subAccountIdstring否子賬戶編號-
subAccountNamestring否子賬戶名稱-
currencystring否幣種編碼 ISO 4217USD
budgetStatusinteger否預算狀態:1=正常,2=禁用-
createTimestring否創建時間-
updateTimestring否更新時間-