Playfff - Deeplink

About

Playfff is the middleware to help Play SRG mobile applications understanding Play web urls.

Since July 2019, Play iOS applications download parsePlayUrl.js v1 file.
Since September 2019, Play Android and Play iOS applications download parsePlayUrl.js v2 file.

The conversion is done with a javascript function, included in the parsePlayUrl.js file. The file is downloaded with the GET API.

Function is: parseForPlayApp(scheme, hostname, pathname, queryParams, anchor):

Parameters: the web url to parse, splitted in variables.
It returns an application url, conform to an old Play iOS application URL specification.

Function is: parseForPlayApp(scheme, hostname, pathname, queryParams, anchor, supportedAppHostnames):

Parameters: the web url to parse, splitted in variables.
supportedAppHostnames: an optional array to share the supported application url hostnames. Required to support the new micropage or page hostnames conversion.
It returns an application url, conform to Play iOS application URL and Play Android custom URL specifications.
An optional preview=true query parameter can be added to the returned application url. It's related to PAC (Play Application Configuration) and it's used to have a preview of the content page.
If the JS script returns the unsupported hostname, the application can share it to the server using the POST API.

The server pulls IL every 5 minutes to have updated contents (topics).

Topic list requests: IL /integrationlayer/2.0/[BU]/topicList/tv.
Topic title are converted to SeoName value used by the Play web application for topic urls.

Curently, unit tests are a on private repository, accessible via a public url:

To test Play web url conversions, a tool is available: