General guidelines for writing applications and libraries for Pryv.io platforms.
Web applications should be implemented to be platform agnostic, so they can be run on your production environment as well as your staging one.
Our example applications can be run on our Pryv Lab platform as well as your own.
Applications should retrieve configuration parameters from the service information.
For this we suggest to implement the following ways to load its configuration:
pryvApiEndpoint query param
An URL in the Basic HTTP Authorization form.
https://firstname.lastname@example.org API endpoint (URL encoded)
Note: service information should be retrieved by appending the path
/service/infoto the value given by
pryvServiceInfoUrl query param
https://reg.pryv.me/service/infoas service information URL (URL encoded)
If multiple parameters are provided, the following order of priority should be used:
pryvServiceInfoUrlas query parameter
pryvApiEndpointas query parameter
pryvServiceInfoUrlas default value
pryvApiEndpoint to load an app allows to load data directly as it usually contains credentials. For cases where you require authentication, it is preferred to use