URL Parameters & Routes
Base URL ({WEBVIEW_URL}) is provided by Lynes when your hosted Webview is provisioned.
{WEBVIEW_URL}/{path}?lang=de&platform=ios&entrypoint=leaderboardQuery parameters
| Parameter | Required | Values | Description |
|---|---|---|---|
lang | No | e.g. de, en | UI language. Default: de |
platform | No | ios, android, web | Platform hint (accessibility). Default: web |
darkmode | No | true, false | Theme on first paint |
entrypoint | No | leaderboard, challenges, offers, shop | Controls when back closes the Webview and returns to your app (see below) |
type | No | local, online | Only on /shops: initial tab (case-insensitive) |
entrypoint (back navigation)
entrypoint is saved in sessionStorage for the tab session. It does not navigate to a route for you.
| Value | Use together with path | Back closes the Webview (returns to your app) when user is on |
|---|---|---|
leaderboard | /leaderboard (and related sub-flows) | /leaderboard |
challenges | /challenges | /challenges |
offers | /offers | /offers |
shop | /shops or /shops/{shopId} with entrypoint=shop | /shops or shop detail (see Native Bridge) |
Correct:
{WEBVIEW_URL}/leaderboard?entrypoint=leaderboard&lang=de&platform=iosIncorrect (opens overview, only stores entrypoint for back logic):
{WEBVIEW_URL}/overview?entrypoint=leaderboardtype on /shops
| Value | Tab |
|---|---|
local | Local / in-person |
online | Online |
{WEBVIEW_URL}/shops?type=online&entrypoint=shop&lang=deNot supported on page URLs
| Parameter | Notes |
|---|---|
userId | Ignored — user comes from JWT sub after session exchange |
token | Not for page loads; debug endpoint /api/auth only |
Routes
Paths are relative to {WEBVIEW_URL}:
| Path | Screen |
|---|---|
/ | Home (overview content) |
/overview | Gamification overview |
/challenges | Challenges |
/leaderboard | Leaderboard |
/leaderboard/info | Leaderboard info |
/offers | Offers / rewards |
/offers/{offerId} | Offer detail |
/offers/{offerId}/book | Book / redeem flow |
/shops | Shops list |
/shops/{shopId} | Shop detail |
/shops/{shopId}/addresses | Addresses |
/redeem/{couponId} | Redeem coupon |
/reward-history | Reward history |
/history | Activity history |
/surveys | Surveys |
/how-it-works | How it works |
You can deep-link to any path. Set entrypoint when the user should leave the Webview (back to your app) from that feature’s root screen.
Examples
{WEBVIEW_URL}/overview?lang=de&platform=ios&darkmode=false{WEBVIEW_URL}/challenges?lang=en&platform=android&entrypoint=challenges{WEBVIEW_URL}/offers/{offerId}?lang=de&platform=iosWebview-internal APIs
Called by the hosted app, not by your native code:
| Route | Method | Purpose |
|---|---|---|
/api/token-exchange | POST | JWT → session |
/api/auth | GET, POST | Debug JWT inspection |