Scheduled maintenance is currently in progress. We will provide updates as necessary.
Posted Mar 01, 2025 - 00:00 CET
Scheduled
Dear Partners,
We want to inform you about some upcoming improvements to the Zaptec API that will enhance efficiency, performance, and reliability. These updates will take effect from 01-03-2025, and we want to ensure you have all the details needed for a smooth transition.
What’s changing?
1. More accurate Error Handling for Charger State Requests Endpoint Affected: GET /api/charger/{id}/state
What’s Changing? - If the requested charger ID does not exist, the API will now return a 404 Not Found instead of 200 OK with an empty list. - New 404 Response Format: { "errorCode": 512, "details": "charger not found" }
Why This Change? This aligns with best practices for API responses, making it clearer when a charger ID is invalid. It helps integrators handle errors correctly and reduces unnecessary retries.
What You Need to Do: Please ensure your integration can handle 404 Not Found responses appropriately. Avoid automatically retrying requests when this status is received.
2. Updated Pagination Limits for Better Performance Endpoints Affected: GET /api/installation GET /api/charger GET /api/chargeHistory
Why This Change? Prevents excessive database load, improving response times. Ensures a more stable and efficient experience for all API users.
What You Need to Do: If your integration currently requests more than 100 records per page, please update it to respect the new limits. If no changes are made, responses will automatically be limited to 100 records per page.
3. Charge History Data Now Limited to the Last 365 Days Endpoint Affected: /api/chargeHistory
What’s Changing? You will only be able to query charge history data for the last 365 days.
Why This Change? Helps optimize database performance by archiving older data. Ensures faster query response times.
What You Need to Do: If your integration queries charge history beyond 365 days, please adjust the date range accordingly.
Next Steps & Support Effective Date: 01-03-2025 Final Rollout: 01-04-2025 We understand that changes like these may require some adjustments, and we’re here to support you through the transition. If you have any questions or need assistance, feel free to reach out to us!
We truly appreciate your collaboration in making these improvements possible. Thanks for being a valued partner!