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"
}
]
}
账单管理
查询月账单明细
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"
}
]
}
请求头
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。
查询参数
string
查询起始月份，格式为
YYYY-MM，例如 2025-10。月账单数据最早从 2025-10 开始查询。int32
页码，从
1 开始。int32
每页数量。
当前生产环境会补齐从
startMonth 起的月份，返回数量可能不会严格等于 pageSize。响应参数
object[]
必填
月账单明细列表。
隐藏 properties
隐藏 properties
string
必填
月账单 ID。
string
必填
用户账号 ID。
string
必填
账单月份，格式为
YYYY-MM。string
必填
月账单应付总额，单位为 1/10000 元。
string
必填
优惠或抵扣前的原始总额，单位为 1/10000 元。
string
必填
代金券支付金额，单位为 1/10000 元。
string
必填
现金支付金额，单位为 1/10000 元。
string
必填
欠费金额，单位为 1/10000 元。
string
必填
已还款金额，单位为 1/10000 元。
string
必填
月账单状态。取值：
pending：未出账。outed：已出账。paid：已支付。overdue：已逾期。voided：已作废。
string
必填
账单或发票下载地址。空字符串表示暂无可下载文件。
string
必填
账单周期开始时间，秒级 Unix 时间戳。
string
必填
账单周期结束时间，秒级 Unix 时间戳。
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"
}
]
}
最后修改于 2026年5月25日
⌘I