This section of the customer portal explains how to integrate IntelliProve into your platform using an SDK or the API to perform health checks and obtain health insights. It is a good place to get started as a developer, but can also be useful information if you are a UI designer. We cover:



The first step in the process is to inform the user about the measurement. It is good practice to explain to the user what the health scan does and how they should correctly perform it. Refer to the Usage instructions for a comprehensive overview. When integrating our product into your own platform or app, we recommend also showing these instructions to the user, in order to increase the chance of them passing the check for conditions. We come back to this in the next step.

After going through the information screen, the health scan screen becomes visible. Here, the user can start the health scan by e.g. pressing a start button.

When pressing the start button, the recording setup should first be reviewed. This check, also referred to as 'quality check', ensures that the recording setup meets a few requirements for a qualitative measurement. This includes, for example, checking if there is sufficient lighting, checking the face-camera distance or analyzing the user's motion. The check is performed based on a single frame of the user's face.

The SDK's automatically perform this step for you. If you're using the API, the check conditions endpoint can be used.

The response of the request can be used to show relevant instructions to the user when the conditions are not met. In that case, the UI element that outlines the face - the indicatory brackets - will change color in our demo app, as shown in the figure below. You can use a similar visual clue in your own platform or app. Below, you can also find a few guidelines with regards to the indicatory brackets.

The quality check is blocking, in other words, the actual measurement can only be started when the check is positive, i.e. the quality conditions are met.

Below is a comprehensive list of possible outcomes of the quality check and corresponding suggested messages towards the user.

When the quality check succeeds, the UI element outlining the face turns green and the app automatically starts recording. The recommended recording time is 30 seconds (also see the Video input requirements). A timer indicates the remaining recording time to the user. During the measurement, the user should keep their face still and look straight into the camera. More information on how to perform the measurement correctly can be found in the Product instructions.

We recommend adding an indication frame to guide the user to keep their face centered, as well as a countdown timer to inform the user when the health check will end.

Once the recording has been finished, the video needs to be processed.

For the user, this should be a seamless process. The app shows a loading sign while uploading the video and waiting for the results. As soon as the processing is done, the app shows the results, which is outlined in the next section.

Behind the scenes, the SDK will handle the necessary steps to process the video for you.

With the processing now finished, the results can be fetched and displayed in the app. The SDK will automatically return these. If you're using the API, use the Get results endpoint and pass the UUID in the request path parameter. The results are returned in json format. The demo app displays the results as shown below. You can find information about the values that are returned in the response in the Insights & biomarkers page.

IntelliProve provides you with the freedom to customize your results to suit your specific requirements. You can connect it to a data model, conduct training verification, or use it to offer advice on therapy or products. The possibilities for customization are endless, but it's important to keep in mind some key considerations.