Latency

Overview

When integrating with Trustfull, it is essential to determine the acceptable response time for your system. The following sections provide a clear understanding of max_enrichment_time, its functionality within the Trustfull environment, and the impact it can have on the results you observe.

The max_enrichment_time parameter defines the maximum duration allowed for data enrichment processes within the Trustfull system. This setting ensures that responses are returned within a specified time frame, maintaining system efficiency and performance.

About response time

In Trustfull's API-based service, response time refers to the total available time for processing and responding to a request. This includes the time it takes for your request to reach our servers, be processed and answered, and for the response to return back to your server. max_enrichment_time and response time are two separate things.

Within Trustfull's system, the response time consists of three main components:

• Network: This refers to the delay in communication over the network when interacting with our APIs.
• Enrichment: This is the time required to gather all the necessary data values for the Data Enrichment process. Please note that response times may vary as Trustfull does not have control over third-party servers and data sources.
• Score: This refers to the time needed to produce a score in our platform

You can add the field max_enrichment_time to the body of your API request. Below is an example:

curl --request POST \
     --url https://api.fido.id/1.0/hub \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR-API-KEY' \
     --data '
{
  "customer_id": "my_customer_id_0001",
  "phone_number": "393485698541",
  "claims": ["phone"],
  "max_enrichment_time": 3.5
}
'

Working with max enrichment time

📘

max_enrichment_time is optional and can be omitted if the use case is not time-sensitive.

To accurately determine the optimal max enrichment time, it's essential to perform a series of experiments using the network configuration that will be operational in production. This approach helps in setting the appropriate max enrichment time based on the specific signal of interest and the required response time.

For detailed guidance on how to conduct such experiments, please refer to the recipes section of our documentation.

When adjusting max enrichment time, be mindful of its impact on coverage. For instance, a small increase at lower levels can significantly enhance coverage. In the example shown, increasing the max enrichment time from 1.7 to 2.2 results in a 40% increase in coverage. On the contrary, a similar increment at higher values, such as from 3.2 to 3.7, yields only a 5% improvement.

This nuanced understanding of max enrichment time adjustments emphasizes the importance of strategic increments based on specific thresholds to optimize performance and coverage effectively.

The tables below show the value of max_enrichment_time that needs to be set to achieve a > 80% coverage on the described signals.