Best practices

Resilience

In our commitment to providing robust and reliable API integration services, it's essential to acknowledge the potential for disruptions that may occur despite flawless execution from both ends. Factors such as network fluctuations or occasional service interruptions within the cloud environment can impact the seamless flow of data.

To mitigate these challenges and ensure uninterrupted operations, it's crucial for customers to incorporate resilience strategies into their integration architecture. Experience has thought us that designing from failure from the very beginning yields much less operational interruptions. Below are key recommendations to bolster the resilience of your API integrations:

1. Retry Mechanisms: Implement retry logic within your systems to automatically retry failed API calls. This feature helps in handling transient issues and ensures that integration processes can recover from temporary disruptions without manual intervention. Examples are infrequent http status 503 or 504 behaviour from load balancers.
2. Queue based requests with Dead-Letter Queues (DLQs): Utilize Queue's/DLQs to capture and store messages or events that couldn't be processed initially. DLQs act as a safety net for preserving data integrity and allow for convenient investigation and resolution of failed messages to replay them when issues have been resolved.
3. Comprehensive Logging: Maintain detailed logs of all API interactions, including requests, responses, and relevant metadata. Logging facilitates effective troubleshooting by providing insights into system behavior and aiding in the identification of potential issues.
4. Unique Identifiers: Each API call is assigned a unique identifier on our side and presented in the response header: Trackingid . These identifiers enhance traceability and enable efficient support by allowing our team to quickly locate and address specific issues as they arise.

By incorporating these resilience measures into your integration workflows, you can minimize the impact of disruptions and ensure smooth access to our cloud services. Additionally, these practices streamline the support process, enabling our team to assist you promptly and effectively whenever needed.

Should you require further assistance or guidance on implementing these measures, please don't hesitate to reach out to our dedicated support team.

Poll vs Push

Currently we strive to provide straightforward rest API's. There is no inherent standard within these types of API's to provide a push mechanism. Polling is therefore the preferred approach. This means if one poll fails chances are that it will be fixed on subsequent polls without having to care about missed push messages and resending them. To facilitate polling and to reduce the amount of data that needs to be looked through, the API endpoints that are often polled support timestamps as query parameter for since functionality. This will only return data that's relevant (updated, created) since that timestamp. If you need to poll one of the API endpoints and a since mechanism is not provided feel free to reach out to us.