分页
StablePay API 对返回多条记录的端点使用分页来提高性能和可用性。
分页参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
page | integer | 1 | 页码，从 1 开始 |
page_size | integer | 20 | 每页记录数，最大 100 |
cursor | string | - | 游标（用于游标分页） |
请求示例
curl https://api.stablepay.co/v1/payment/sessions?page=1&page_size=20 \
-H "Authorization: Bearer sk_test_abc123..."
响应格式
{
"data": [...],
"pagination": {
"page": 1,
"page_size": 20,
"total": 150,
"total_pages": 8,
"has_more": true
}
}
游标分页
对于大数据集，建议使用游标分页以获得更好的性能：
curl https://api.stablepay.co/v1/transactions?cursor=cursor_abc123 \
-H "Authorization: Bearer sk_test_abc123..."