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