Last modified: Nov 10, 2024

Query parameters

Available query parameters for an app.

returnUrl

Query parameter returnUrl is used by the app to redirect users to that value when they click the exit-button in the app.

Rules:

  • returnUrl must have a valid URL-format
  • The host defined in returnUrl must be the same host as the URL has (see example below).
  • The value of returnUrl must be a base64-encoded string

Example without base64-encoded string:
https://foo.apps.tt02.altinn.no/foo/bar?returnUrl=https://foo.apps.tt02.altinn.no/foo/foobar

Example with base64-encoded string:
https://foo.apps.tt02.altinn.no/foo/bar?returnUrl=aHR0cHM6Ly9mb28uYXBwcy50dDAyLmFsdGlubi5uby9mb28vZm9vYmFy

Here one can see that returnUrl has a valid URL-format and it has the same host name as the app defined in the beginning.

For readability, the examples below does not use base64-encoded strings.

One can not link to a different host name, this will not pass query parameter validation:
https://foo.apps.tt02.altinn.no/foo/bar?returnUrl=https://foo.apps.altinn.no/foo/foobar

It is important to have the correct order of query parameters and special characters in the URL. Here is an example showing a correct URL:
https://ttd.apps.at21.altinn.cloud/ttd/level1-app?returnUrl=https%3A%2F%2Fttd.apps.at21.altinn.cloud%2Fttd%2Fapps-test%2F%23%2Finstance%2Finstanceownerid%2Finstanceguid/#/instance/instanceownerid/instanceguid