Request plug-in URL

intro to integrate the plug in within your website or mobile app, you will need a temporary authenticated url example https //plugin intelliprove com?action token=\<action token>\&patient=\<patient> validity the action token embedded in the url has a fixed expiry time currently, this is set to 6 hours, meaning the url will no longer be valid after that a new temporary url should be requested after expiring prerequisites if you haven't already, go through our web plug in overview docid\ fwrilxhap81oojwmwf3tr to get a clear understanding of the plug in flow and its features request url requesting a temporary web plug in url can be done with a simple http get call to the intelliprove api please note that this step requires a valid intelliprove api key exposing this api key to the client side is bad practice you should not incorporate the api key in your js browser code instead, resolve the plug in url from a backend server please be aware that the url provided in the response is subject to change this involves not just the action token part, which varies with each new request, but also the subdomain of the url, which may change when new versions of the plugin are released consequently, make sure not to hardcode any elements of this url instead, consistently utilize the entire response url as obtained additional query parameters the web plug in url allows adding additional session parameters via query parameters these parameters are not mandatory but are recommended for enhanced functionality language specify the language to allow the web plug in to default to your preferred locale the language code should consist of a two letter language code the currently supported languages are "en" ( english , default) and "nl" ( dutch ) please contact us if other languages should be supported patient ref recommended add a unique reference to track which user ('patient') was been measured this allows us to keep track of previous health scans of the patient and use these for long term health trends take into account that this is required to obtain an outcome for the mental health risk docid\ m81stnwaivxts8hsvocxt parameter make sure the 'patient reference' is a hashed, pseudonymized reference! an example is provided here https //archbee doc uploads s3 amazonaws com/xeqfuy6fqgd 3sclwlsvd 7oaukeadvsfxv 7a4 xy 20240808 144411 html performer ref add a unique reference to track who performed each measurement this allows you to group measurements performed by a specific health professional or at a specific location on your website when to request the url? it's a good practice to request a new url for every new session initiated, i e , every new end user logging into your platform for each new session, ensure to request a new url via our api, and include the user's id in the patient ref query parameter once generated, the same url can be used for the same user for up to 6 hours, after which a new request will be necessary you can paste the obtained url in your browser to play with the health scan and show off a first poc! next steps now, that you understand how to request the plug in url, it's time to embed the plug in component in your app continue with the embed plug in docid\ vywpzgyzobqqswusjqy 4 documentation