Proofspace ProofSpace mobile application (main app) has functionality to handle calls from third-party applications via Deeplinks (https://en.wikipedia.org/wiki/Mobile_deep_linking ) and Applinks (calling native application from a web page). With both calls, the main app can be requested to execute specific interactions and prefill attributes of certain self-attested credentials.
...
[<https>|<custom schema>]://[application domain]/native/execute/[base64 encoded request json]
| Info |
|---|
Note: URL safe Base64 encoding must be used. Otherwise some links can appear not readable by the application. |
For application domains and custom schemas see below.
The request format follows the ActionInstance DTO ActionInstanceInfoDTO (https://github.com/zakaio/service-dashboard-backend/blob/master/src/dto/ActionInstanceDTO.ts) with several additional fields.
One of those fields is the optional field url sourceURL. If the URL sourceURL field is present presents and has a web URL, the remaining fields are ignored and used to download the ActionInstance object for further processing. In this case, the downloaded object's URL sourceURL field is ignored in any state to prevent recursion.
...
Depends on application environment application is configured to requests towards following domains:
ProofSpace:
zakaproofspace.ioidProofSpace test:
test.zakaproofspace.ioidProofSpace staging:
stage.zakaproofspace.ioidProofSpace preprod:
prod-test.zakaproofspace.ioid
Constrains
For an ActionInstance object downloaded via the URL sourceURL field or the request, its URL sourceURL field is ignored with any state to prevent recursion.
...
In case of initiating an interaction from a QR code, the user will scan it with a system using the system or the built-in scanner and get switched to the main app to the interaction screen.The callback behavior in the case of the Applink call is not defined at the time.
If the main app is not installed on a user's device, during the app link call, the ProofSpace dashboard will be opened, and it is supposed to show a page with the links to the app stores to install it.
...