Wat is deeplinken?
De portal heeft de mogelijk om middels een deeplink in te loggen. Dat wil zeggen dat de URL zowel de gebruikersnaam als het wachtwoord bevat. Hierdoor komt de gebruiker ingelogd de portal binnen. Middels een deeplink kan de gebruiker vanuit een webpagina of applicatie naar een specifieke pagina op de portal van Raab Karcher gestuurd worden. Doordat de deeplink elementen als de gebruikersnaam, wachtwoord, redirect of eventuele settings bevat komt de gebruiker inlogd op de pagina terecht en hoeft deze niet meer zelf in te loggen.
Opbouw van de deeplink URL
De deeplink functionaliteit kan worden aangesproken via de volgende URL:
https://www.raabkarcher.nl/session/?
Achter het vraagteken moeten / kunnen een aantal variabelen opgegeven worden:
| Element | Omschrijving | Verplicht |
|---|---|---|
| userid | U dient verplicht het userid element mee te geven. Achter userid= wordt de gebruikernaam van de gebruiker ingevoerd. | Ja |
| guid / password | U dient verplicht het wachtwoord van de gebruiker mee te geven om in te loggen. Dit kan op twee manieren: · Via het guid element (aanbevolen). In dit geval wordt het wachtwoord als MD5 hash meegestuurd. · Via het password element. In dat geval moet het wachtwoord als string meegegeven worden. |
Ja |
| redirect | Als de gebruiker na het inloggen op een specifieke pagina terecht moet komen dan kan dit als redirect in de deeplink opgenomen worden. Als u geen redirect meegeeft wordt de gebruiker naar de homepage geleid. U geeft als redirect alles mee wat achter https://www.raabkarcher.nl geplaatst wordt. Enkele voorbeelden: · /catalogus/ Om naar de catalogus te gaan · /catalogus/product/[artikelnummer]/deeplink/ Om direct naar een artikeldetailpagina te gaan. Vervang [artikelnummer] in de url door het artikelnummer. · /catalogus/zoeken/?q=[zoektekst] Om direct te gaan zoeken naar een bepaalde zoektekst. Vervang [zoektekst] door de tekst waarnaar u wilt zoeken, b.v. een ean of type nummer. |
Nee |
| [settings] | Voor bepaalde applicaties is het nodig om settings mee te sturen tijdens het inloggen. Deze settings kunnen ook in de deeplink worden opgenomen. Hierbij moet zowel de naam alsook de waarde van de setting in de URL opgenomen worden. Let op: deze instellingen hoeft u alleen te maken als daar expliciet om wordt gevraagd. We kennen nu de volgende settings: · hookurl=[url] Setting voor OCI om de HOOK URL in te stellen. Vervang [url] door de HOOK URL. · Ociversion=[versienummer] Setting voor OCI om de OCI Versie in te stellen. Vervang [versienummer] door het versienummer. |
Nee |
Het gebruik van het guid element heeft de sterke voorkeur boven het gebruik van het password element. Als niet mogelijk is om het guid element te gebruiken en alleen het element password gebruikt kan worden dan moeten speciale tekens vertaald worden in de URL naar HTML codering, omdat deze tekens in de url een andere betekenis hebben. Het gebruik van deze tekens kan ervoor zorgen dat de deeplink niet werkt. Het gebruik van een %-teken in een wachtwoord is af te raden, aangezien dit teken ook onderdeel is van de vertalingen.
In de portal kan het wachtwoord gewijzigd worden onder Mijn account > mijn instellingen.
Voorbeelden
Gebruiker henk logt in met plaintext wachtwoord en komt op de homepage
https://www.raabkarcher.nl/session/?userid=henk&password=Welkom01!
Gebruiker henk logt in met plaintext wachtwoord (Ab#2345) en komt op de homepage
https://www.raabkarcher.nl/session/?userid=henk&password=Ab%232345
Gebruiker Piet logt in met guid en linkt door naar productdetailpagina
https://www.raabkarcher.nl/session/?userid=henk&guid=b1461f9e14414e5318a33bb84c242e56&redirect=/catalogus/product/7000201062/sphinx-monaco-wandtegel-25x40cm-/