NodeJS SDK
The NodeJS SDK enables you to use IntelliProves features with ease.
Requirements
- NodeJS
This SDK only provides tools for back-end servers. This is due to the requirement of File IO. Our front-end SDK can be found here: https://docs.intelliprove.com/sdk
Tested on
- NodeJS 16.x
- NodeJS 18.x
- NodeJS 19.x
Support is guaranteed for the NodeJS versions mentioned above. Other versions are most likely supported but not tested.
Recommendations
We recommend the use of TypeScript as it provides type hints and a better developer experience. However our SDK works as CommonJS as well.
Installation
You can find our SDK on the node package manager repository for easy installation:
https://www.npmjs.com/package/intelliprove-sdk
Updating the sdk
Authentication
More info on authentication and the API key can be found here: API docs .
Functionality
Check conditions
Check the quality of a given image before upload. Returns a QualityResponse object with feedback on whether your video/image is usable and why it might not be usable.
Parameters:
- path: string - path to the a image you want to run the quality check on
Upload a video
Easily upload a video to IntelliProve for analysis of the subject's biomarkers. Returns the uuid of the uploaded video, which can be used to get the results.
NOTE: The quality check needs to be successful before you can upload a video.
Parameters:
- path: str - path to the video you want to process
- quality_response: QualityResponse - the response from the quality check method
- patient: string - An optional field to set the patient reference
- performer: string - An optional field to set the performer reference
Get the results of a video
Returns the results of a processed video for a given uuid as a Biomarkers object.
NOTE: This uses long polling, when demand is high this call can take a while.
Parameters:
- uuid: string - The UUID returned by the upload method
Get the current customers info
Get the current customers information by API key.
Models
Those are simple representations of the models accessible through the SDK and their helper functions. All models have a .json() method to convert it to a normal JS object in case this is preferred.
QualityResponse
Describes the quality of an image.
Helpers
- success(): boolean - Has the quality check succeeded
BiomarkersResponse
Holds the results of an analysed video after upload.
UserInfo
Contains information of the current user.
Helpers
- hasEmail(): boolean - Has the customer a valid email
- isAdmin(): boolean - Is the current customer an administrator for their organisation
- isContributor(): boolean - Is the current customer a contributor
- isUser(): boolean - Is the current customer a regular user
Example usage
Provided with a valid API key and a valid image and video path, this code snippet runs from start to finish and prints out each intermediate result to the console.