majiayu000 Pagination Parameter Standard
Request Parameters
| Param | Full Name | Type | Default | Description |
|---|---|---|---|---|
o |
offset | number | 0 | Offset, starting from which record |
s |
size | number | 42 | Page size |
Response Parameters
| Param | Full Name | Type | Description |
|---|---|---|---|
d |
data | array | Data list |
t |
total | number | Total record count |
p |
pages | number | Total page count |
Usage Examples
Backend Interface
interface PageQuery {
o?: number // offset, default 0
s?: number // size, default 42
}
interface PageResult<T> {
d: T[] // data list
t: number // total count
p: number // total pages
}
Frontend Query Params
GET /api/users?o=0&s=42
GET /api/users?o=42&s=42 // page 2
Frontend Pagination Calculation
// page number to offset
const offset = (page - 1) * size
// offset to page number
const page = Math.floor(offset / size) + 1
// total pages
const totalPages = Math.ceil(total / size)
Design Philosophy
Single-letter minimal parameter naming reduces network transmission characters. Significantly lowers bandwidth consumption in high-frequency call scenarios.