Sök-API och Tjänsteguide

Marknadsdatabasen har ett sök-API (

Marknadsdatabasen: Search 1.1) som möjliggör KO att söka på adresser på sin egen hemsida och presentera ett svar gentemot slutkund (till exempel "Grattis, du är ansluten!")

Om KO vill skicka kunden till Tjänsteguiden, automatiskt eller via länk, så rekommenderar vi att man skickar med vilket accessId som adressen har, så kund slipper söka på sin adress igen i Tjänsteguiden.

Så istället för att länken till tjänsteguiden ser ut till exempel så här:

https://konamn.stadsnatsportalen.se/serviceguide/index/consumers

Så skapar man en länk som ser ut så här:

https://konamn.stadsnatsportalen.se/serviceguide/index/consumers?accessid=12345

Dotterwebbar

Om ni har fler webbar/tjänsteguider som är uppsatta som dotterwebbar, så kommer resultatet via API:et inkludera dessa med, så en sökning på "Björnvägen" kan hitta "Björnvägen" på moderwebben i city, men också i en dotterweb på landsbygden till exempel (eller bara på en dotterweb), där är det viktigt att ni i ert system som anropar API:et skickar kund till rätt dotterwebb, vilken MdB som är ursprung till adressen i resultatet ser ni i fältet coId där varje web har ett eget unikt coId.

Embed

Om ni använder Atlas Embed så ska länken till Tjänsteguiden inte gå direkt till Tjänsteguide-servern utan er egen sökväg som i sin tur laddar Tjänsteguiden. Där länken kanske är

https://www.ko.se/tjanster

Som då i sin tur laddar

https://embed.ko.se/serviceguide/index/consumers

Men om ni skickar kunden till

https://www.ko.se/tjanster?accessid=12345

Så kan inte Tjänsteguiden "se" det då det är information som enbart er web är medveten om, så i scriptet som ni laddar via Atlas Embed så måste ni alltså skicka med detta, om det finns, så script-taggen ni laddar ser ut som följer:

<script src="https://embed.ko.se/atlas/include/javascript/embed.js?atlas_path=/serviceguide?accessid=12345"></script>