Deep Link Handler
API Contract
REST
/api/v1/deep-links
4 endpoints
GET
/api/v1/deep-links/api/v1/deep-links
List recorded incoming deep links
Public
Response Example
{
"data": [
{
"link_id": "dl_9a8b7c6d",
"uri": "myapp://vipps-callback?code=auth_code_aBcDeFgH1234&state=rnd9xkT2",
"type": "vipps",
"processed": true,
"received_at": "2026-03-26T10:11:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1
}
}
POST
/api/v1/deep-links/api/v1/deep-links/parse
Parse an OAuth callback URI into structured fields
Public
Request Example
{
"uri": "myapp://vipps-callback?code=auth_code_aBcDeFgH1234&state=rnd9xkT2"
}
Response Example
{
"provider": "vipps",
"code": "auth_code_aBcDeFgH1234",
"state": "rnd9xkT2",
"error": null,
"error_description": null
}
GET
/api/v1/deep-links/api/v1/deep-links/initial
Get the initial deep link that launched the app
Public
Response Example
{
"uri": "myapp://bankid-callback?session=bids_3e9c1f2a&assertion=eyJhbGc...",
"received_at": "2026-03-26T10:10:30Z"
}
POST
/api/v1/deep-links/api/v1/deep-links/initialize
Initialize deep link listener for the session
Public
Request Example
{
"device_id": "dev_mobile_01"
}
Response Example
{
"initialized": true,
"listening": true,
"initialized_at": "2026-03-26T10:00:00Z"
}