API Development And
Integration Guide
Pagination Standards
Efficient pagination enhances performance, user experience, and API reliability. WUPEX follows page-based pagination, a widely adopted and predictable method that’s easy to implement across products and orders endpoints. This section details our approach, standards, and best practices.
How It Works
- Request parameters:
- page: integer (min 1), default = 1
- pageSize: integer (max 100), default = 20
Sample request:
json
{ "page": 2, "pageSize": 20 }
Response includes a pageInfo object:
json
"pageInfo": {
"totalPage": 5,
"totalCount": 95,
"pageSize": 20,
"currentPage": 2
}
- Why Choose Page-Based Pagination
- Predictable navigation: Avoids skipped or duplicate pages compared to offset-based systems
- Consistent for moderate dataset sizes: Ideal for product and order sets with relatively stable record counts medium.com
- Simple to implement & maintain: Aligns closely with standard SQL queries (LIMIT + OFFSET) and is widely supported
- Tells the API your preferred localization format (“en-US”). Using headers for localization is a standard practice and recommended over URL or payload methods .
- Limitations & Alternatives
- 1. Offset performance with large data sets
- As page increases, retrieval might slow down due to internal offset computations
- 2. Page drift in dynamic datasets
- Rapid data changes may shift item positions slightly—acceptable in WUPEX’s typical use cases
- Future enhancements:
- Keyset (cursor-based) support for seamless infinite scroll and large lists
- Time-based cursors for audit logs and order history
- Best Practices
- 1. Set reasonable defaults
- Keyset (cursor-based) support for seamless infinite scroll and large lists
- Time-based cursors for audit logs and order history
- 2. Return complete metadata
- Include pageInfo in every response for UI or client-driven paging
- 3. Stable sorting assumptions
- Use predictable sorting (productCode, orderDate) for consistent pagination results
- 4. Graceful handling of invalid pages
- If page exceeds totalPage, return data: [] with correct metadata.
- 5. Avoid large pageSize values
- Too-large pages (e.g., >100) may strain performance.
- 6. Provide clear navigation logic
- Implement "next / previous" page functionality using currentPage and totalPage.
Implement "next / previous" page functionality using currentPage and totalPage.
json
{
"page": 1,
"pageSize": 25
} 20 }
json
"pageInfo": {
"totalPage": 4,
"totalCount": 90,
"pageSize": 25,
"currentPage": 1
}
- For page 2, request:
json
{ "page": 2, "pageSize": 25 }
- and expect the next batch of records.
Get Started
Product API
Order API
Customer API
Common Parameters & Headers
Error Handling & Status Codes (Optional)
Postman Collection & Tools (Optional)
Let’s Boost Your
Business Efficiency
Say goodbye to delays, fraud, and complex setups—our solution is built for speed and trust.
Get Latest News for Free!
Sign up to get product updates, new partner alerts, and
exclusive API insights
exclusive API insights
No spam. Unsubscribe anytime
Why WUPEX?
Partners
- Apple
- PSN
- Razer Gold
- Xbox
- PUBG
- Steam
- Jawaker
- Roblox
- Fornite
- Minecraft
- Yalla Ludo
- FC Mobile
- Freefire
Industries
- Banks & Fintech
- Retail & eCommerce
- Payment Gateways
- Telecom & Wallets
- Gaming & Esports
- Corporate Gifting
Resources
- Blog
- FAQ
Company
- About Us
- Meet Our Team
- Contact Us
- Partnership
- Terms & Conditions
Downloads
- Catalogue
- Company Profile
- API Documentation
Features
- Seamless Integration
- Secured API
- Real-Time Delivery
- Bulk Digital Gift Cards
- Fraud Prevention
- Global Brand Access
Support
- Get Started
- Customer Support
- Portal Guide
- API Integration Guide
- Help Center
Copyright © 2024 WUPEX | All Rights Reserved.
Why WUPEX?
Partners
- Apple
- PSN
- Razer Gold
- Xbox
- PUBG
- Steam
- Jawaker
- Roblox
- Fornite
- Minecraft
- Yalla Ludo
- FC Mobile
- Freefire
Industries
- Banks & Fintech
- Retail & eCommerce
- Payment Gateways
- Telecom & Wallets
- Gaming & Esports
- Corporate Gifting
Features
- Seamless Integration
- Secured API
- Real-Time Delivery
- Bulk Digital Gift Cards
- Fraud Prevention
- Global Brand Access
Support
- Get Started
- Customer Support
- Portal Guide
- API Integration Guide
- Help Center
Company
- About Us
- Meet Our Team
- Contact Us
- Partnership
- Terms & Conditions
Resources
- Blog
- FAQ
Downloads
- Catalogue
- Company Profile
- API Documentation
Copyright © 2024 WUPEX | All Rights Reserved.