Understanding the is_archived Field Change
Ringover has implemented a significant change to the is_archived field in their Public API calls endpoint. As of 14/05/25, this field now returns a numeric value instead of a boolean. The public documentation was subsequently updated on 22/05/25 to reflect this change. This modification was made to resolve previous errors in the API, enhancing its overall functionality and reliability.
Implications for Developers
Developers integrating with the Ringover API should be aware that the is_archived field now returns an integer rather than a true/false boolean. Typically, you can expect values such as 0 or 1 to represent the archival status of a call. This change requires adjustments in how you handle and interpret the data received from the API.
Proper Handling Techniques
To accommodate this change, developers should update their code to properly handle numeric values for the is_archived field. Instead of directly comparing to boolean true/false, you'll need to check for numeric values. For example:
// Example pseudocode
if (call.is_archived == 1) {
// Call is archived
} else {
// Call is not archived
}
Troubleshooting and Best Practices
If you encounter API field type errors related to this change, follow these steps:
- Review your API integration code to ensure data types match Ringover's expected formats
- Validate that all data fields are correctly formatted before transmission
- Check Ringover's API documentation for precise field type requirements
- If issues persist, provide detailed error information to Ringover's technical support team
Additional Resources and Support
For comprehensive information about Ringover's API and SDK integration, refer to these resources:
- Developer Documentation: https://developer.ringover.com/
- SDK Repository: https://github.com/ringover/ringover-sdk
- Pagination Guide: https://developer.ringover.com/#tag/How-to-paginate
For additional support, contact Ringover's customer support during business hours (Monday to Friday, 9:00 AM to 6:00 PM). The public API documentation provides detailed information about available endpoints, functionality, and integration methods for connecting with Ringover's services.