跳转到主要内容
GET
/
openapi
/
v1
/
billing
/
monthly
/
bill
curl --request GET \
  --url 'https://api.ppio.com/openapi/v1/billing/monthly/bill?startMonth=2025-10&page=1&pageSize=20' \
  --header 'Authorization: Bearer <API_KEY>'

{
  "data": [
    {
      "billId": "<string>",
      "userId": "<string>",
      "billingMonth": "2025-12",
      "totalAmount": "1000000",
      "originTotalAmount": "1200000",
      "voucherPayAmount": "200000",
      "cashPayAmount": "800000",
      "debtAmount": "0",
      "status": "paid",
      "invoiceUrl": "",
      "startTime": "1764547200",
      "endTime": "1767225599",
      "repaidAmount": "0"
    }
  ]
}

​
请求头

​
Authorization
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。

​
查询参数

​
startMonth
string
查询起始月份，格式为 YYYY-MM，例如 2025-10。月账单数据最早从 2025-10 开始查询。
​
page
int32
页码，从 1 开始。
​
pageSize
int32
每页数量。
当前生产环境会补齐从 startMonth 起的月份，返回数量可能不会严格等于 pageSize。

​
响应参数

​
data
object[]
必填
月账单明细列表。
curl --request GET \
  --url 'https://api.ppio.com/openapi/v1/billing/monthly/bill?startMonth=2025-10&page=1&pageSize=20' \
  --header 'Authorization: Bearer <API_KEY>'

{
  "data": [
    {
      "billId": "<string>",
      "userId": "<string>",
      "billingMonth": "2025-12",
      "totalAmount": "1000000",
      "originTotalAmount": "1200000",
      "voucherPayAmount": "200000",
      "cashPayAmount": "800000",
      "debtAmount": "0",
      "status": "paid",
      "invoiceUrl": "",
      "startTime": "1764547200",
      "endTime": "1767225599",
      "repaidAmount": "0"
    }
  ]
}