1. Home
  2. Docs
  3. API Connection Guidelines
  4. User notification
  5. Deep link

Deep link

You can notify your users of a new script by sending them a deep link to Scriptation (e.g. by email). Scriptation will decode this link and redirect the user to the specified folder so they can download the new file. Scriptation will use the previously defined endpoints to retrieve the folder content as well as download the file so any unauthorized access can be denied.

To create a deep link to Scriptation, please use the following URL Scheme:

scriptation://cloudfolder?provider_id={provider-id}&params={scrambled-params}

Parameters
provider-id(string) Provider id assigned to you by Scriptation’s team.
scrambled-params(string) Scrambled version of the complete path to the desired folder. To construct follow the following steps:

1. Initiate the folder path from the root folder, then concatenate all folder-ids, separating them by a “/”, until you reach your target folder.

 root/{item-id1}/{item-id2}.../{item-idn}

2. Encode the string using NSUTF8StringEncoding
3. Convert the resulting string to base64
4. Scramble the resulting string using the following dictionary, where the key is the original character and the value is the new character.

For example:

// BASE64: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=
// SCRAMBLED: ABCDEFGHIJKLMabcdefghijklmNOPQRSTUVWXYZnopqrstuvwxyz5678901234-_*

        _scrambling = @{@"N":@"a",
                        @"O":@"b",
                        @"P":@"c",
                        @"Q":@"d",
                        @"R":@"e",
                        @"S":@"f",
                        @"T":@"g",
                        @"U":@"h",
                        @"V":@"i",
                        @"W":@"j",
                        @"X":@"k",
                        @"Y":@"l",
                        @"Z":@"m",
                        @"a":@"N",
                        @"b":@"O",
                        @"c":@"P",
                        @"d":@"Q",
                        @"e":@"R",
                        @"f":@"S",
                        @"g":@"T",
                        @"h":@"U",
                        @"i":@"V",
                        @"j":@"W",
                        @"k":@"X",
                        @"l":@"Y",
                        @"m":@"Z",
                        @"0":@"5",
                        @"1":@"6",
                        @"2":@"7",
                        @"3":@"8",
                        @"4":@"9",
                        @"5":@"0",
                        @"6":@"1",
                        @"7":@"2",
                        @"8":@"3",
                        @"9":@"4",
                        @"+":@"-",
                        @"/":@"_",
                        @"=":@"*"};