财务汇总

查询你的财务和计费的汇总信息。

**提示：**返回的数据截止至上一个小时或更早时候，它与控制台中显示的数据相比可能有1个小时或更长的延迟。

获取权限#

必须由帐号所有者在控制台为凭据开通权限后才可以访问本接口。

1. 前往控制台-项目管理
2. 点击需要启用控制台API的凭据
3. 向下滑动至“控制台权限”
4. 勾选“允许访问财务汇总数据”
5. 点击“保存”按钮

请求路径#

GET /finance/v1/summary

参数#

请求示例#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/finance/v1/summary'

请将your_token替换为你的JWT身份认证，将your_api_host替换为你的API Host

试一下

返回数据#

{
  "metadata": {
    "tag": "2a9873efd0a6c75665dc4f6116b19bdf"
  },
  "asOf": "2024-04-03T17:13Z",
  "currency": "CNY",
  "balance": -17.54,
  "accruedCharges": {
    "previousDay": 28.92,
    "thisMonth": 113.12,
    "sinceLastBill": 113.12
  },
  "pendingBills": [
    {
      "number": "20681CYX",
      "date": "2024-04-01T10:00Z",
      "type": "PayAsYouGo",
      "status": "unpaid",
      "amount": 535.1,
      "amountDue": 17.54,
      "dueDate": "2024-04-10T23:59Z"
    },
    {
      "number": "605D0FYX",
      "date": "2024-04-02T13:34Z",
      "type": "SavingsPlans",
      "status": "unpaid",
      "amount": 2000,
      "amountDue": 2000,
      "dueDate": "2024-04-30T12:59Z"
    }
  ],
  "availableSavingsPlans": [
    {
      "billNumber": "605D0FYX",
      "status": "pending",
      "term": "1",
      "commitments": 2000,
      "utilized": 0,
      "effectiveTime": "2024-04-30T13:00Z"
    }
  ],
  "availableResourcePlans": [
    {
      "billNumber": "613D1FYX",
      "status": "active",
      "requests": "1000000",
      "commitments": 2000,
      "utilized": 12,
      "effectiveTime": "2024-04-03T17:00Z"
    }
  ]
}

• metadata object 当前响应的元数据
  • tag string 数据唯一标识
• asOf date-time 当前数据的截止日期
• currency string 货币代码，包括：CNY和USD
• balance number 可用额度
• accruedCharges object 应计费用
  • previousDay number 前一天应计费用总额
  • thisMonth number 本月应计费用总额
  • sinceLastBill number 从上次出账以来的应计费用总额
• pendingBills array 待支付时账单列表
  • number string 账单号
  • date date-time 账单出账日期
  • type string 账单的类型
  • status string 账单的状态，包括：unpaid和overdue
  • amount number 账单的总金额
  • amountDue number 账单剩余应付金额
  • dueDate date-time 应付日期
• availableSavingsPlans array 可用的节省计划列表
  • billNumber string 账单号
  • status string 节省计划状态，包括 pending和active
  • term string 承诺期限
  • commitments number 承诺金额
  • utilized number 已用承诺金额
  • effectiveTime date-time 生效时间
• availableResourcePlans array 可用的资源包列表
  • billNumber string 账单号
  • status string 资源包状态，包括 pending和active
  • requests number 总请求量
  • utilized number 已使用的请求数量
  • effectiveTime date-time 生效时间