财务汇总

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

**提示：**返回的数据截止至上一个小时或更早时候，它与控制台中显示的数据相比可能有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

    生效时间