Riktiga Vykort Partner App Teknisk beskrivning I denna tekniska beskrivning finns instruktioner på filformat och storlek för texter, loggor, bilder och ramar som skall läggas in i ditt partnererbjudande. Har du frågor kontaktar du i första hand PostNord kundservice via e-post, kundservice.digital.se@postnord.com. 2015-11- 01
Operativsystem ios Behörighet 1. Bundle-ID Din app s Bundle-iD skall vara registrera hos PostNord. Detta ger din app behörighet att öppna appen Riktiga Vykort och föra över bilden som skall skickas som vykort tillsammans med den information som skall printas på baksidan på vykortet. Du anger din app s Bundle-iD i Orderformuläret när du tecknar avtal om tjänsten. 2. Möjlighet att kunna redigera bild eller inte Informera PostNord om det skall vara möjligt för användaren att kunna redigera bilden i appen Riktiga Vykort eller inte. Med redigering menas att t ex zooma i bilden och lägga till ramar till bilden. Default är att PostNord har spärrat bild för redigering som hämtas från annan app. Du anger detta i Orderformuläret när du tecknar avtal om tjänsten. Konfigurera egen app 1. Namngivning av egen app Ett URL-schema måste finnas definierat i den egna appen för att användaren skall kunna komma tillbaka till appen efter att ett vykort är skickat. 1. Lägg till parametrarna "URL identifier" och "URL Schemes Item" i appens konfigurationsfil (info.plist) för att stödja ett eget url schema. 2. Lägg in parametrar för "URL Schemes Item" enligt information på fliken "PostNords iphone-appar" 3. Sätt parametern "URL identifier" till samma värde som finns i appens "Bundle identifier" 4. Skicka information om din app's "Bundle identifier" till hakan.mg.bergstrom@postnord.se Så här ser det ut i appen Riktiga Vykort: Mer info finns här: http://bit.ly/xmbbzf 2
2. Att kunna öppna appen Riktiga Vykort För att anropa Riktiga Vykort från en annan app utan att skicka med en bild ange: posten-rv://?app=app-name (exempelvis posten-rv://?app=krax) App-name = Din egen apps URL Scheme 3. Att öppna appen Riktiga Vykort och skicka med en bild Normalt sett skickar du en länk till din bild med http:// följt av sökvägen till bilden, för att istället skicka bilden till appen Riktiga Vykort så ersätter du http:// med posten-rv:// istället. Efter sökvägen kan du skicka med parametrar som låter dig styra hur bilden ska visas, mer om detta i nästa del. För att anropa Riktiga Vykort från en annan app och skicka med en bild: posten-rv://url.to.your/photo.jpg?id= your.bundle.identifier&appname=your_appname&icon=http://url.to.your.app_icon/57x5 7.jpg&title= Fin utsikt över staden Barcelona&author=Karl Johansson Innan denna skickas måste länken formateras: NSString *formattedurl = [unformattedurl stringbyaddingpercentescapesusingencoding:nsutf8stringencoding]; För att sedan skicka till appen Riktiga Vykort: [[UIApplication sharedapplication] openurl:formattedurl]; 4. Parametrar som skickas med bilden id = Ditt bundle id, som t.ex com.mittföretag.minapp, denna måste skickas med för att appen ska kunna läsa in bilden, samt att ditt id måste registreras innan användning. title = Titel på bilden (Skrivs ut på baksidan om inga andra titlar är definierade (titlese, titledk samt titleen) titlese = Svensk titel på bilden (Skrivs ut på baksidan om vykortet är adresserat till Sverige och Norge) titledk = Dansk titel (Skrivs ut på baksidan om vykortet är adresserat till Danmark) titleen = Engelsk titel (Skrivs ut på baksidan om vykortet är adresserat till annat land) author = Fotografens namn och/eller ägare av bilden. Max 35 tecken. icon = Länk till appens ikon, ikonen skall vara 57x57 stor appname = Appens namn. Max 15 tecken. 3
5. Knapp i egen app För bilder som skall kunna skickas som vykort skall du lägga in en knapp som heter Vykort. För app med språkstöd engelska, Postcard. Knappen skall öppna en pop-up i din app enligt nedan. 6. Pop-up i egen app När användaren klickar på Vykorts -knappen skall en pop-up visas. I pop-up:en visas text samt ikonen för Riktiga Vykort. Ikon Riktiga Vykort Länken till ikonen som skall visas i pop-up https://posten.estarrebel.com/archive/images/iconriktigavykort.png OBS. Ikonen ändras över året, så lägg inte länken i en klass som cachar bilden utan ställ in så att appen alltid hämtar aktuell bild. Användaren har rätt version av appen Riktiga Vykort 4
Användaren har fel version av appen Riktiga Vykort Användaren har inte appen Riktiga Vykort 7. Riktiga Vykort i AppStore Följande länk https://itunes.apple.com/se/app/riktiga-vykort/id444458799?mt=8 Baksidan på vykortet Utifrån inkomna parametrar så skrivs följande information ut på baksidan av vykortet: Vykort med mottagaradress till Sverige och Norge 5
Vykort med mottagaradress till Danmark Vykort med mottagaradress till övriga världen 6
Operativsystem Android Behörighet 1. Paket namn Din app s Paket namn skall vara registrera hos PostNord. Detta ger din app behörighet att öppna appen Riktiga Vykort och föra över bilden som skall skickas som vykort tillsammans med den information som skall printas på baksidan på vykortet. Du anger din app s Paket namn i Orderformuläret när du tecknar avtal om tjänsten. 2. Möjlighet att kunna redigera bild eller inte Informera PostNord om det skall vara möjligt för användaren att kunna redigera bilden i appen Riktiga Vykort eller inte. Med redigering menas att t ex zooma i bilden och lägga till ramar till bilden. Default är att PostNord har spärrat bild för redigering som hämtas från annan app. Du anger detta i Orderformuläret när du tecknar avtal om tjänsten. Konfigurera egen app 1. Egen app - Paketnamn Ett Paketnamn måste finnas definierat i den egna appen för att man skall kunna komma tillbaka till appen efter att ett vykort är skickat. Det är "Paketnamn" som är kopplingen mellan olika appar. 2. Att kunna öppna appen Riktiga Vykort Om man vill starta Riktiga Vykort från en annan app på Android görs det med följande ett anrop som frågar OS:et om applikationspaketet finns installerad och i så fall att starta den. Så här ser koden ut för anrop till Riktiga Vykort: final String RIKTIGA_VYKORT_PACKAGE_NAME = "se.posten.riktigavykort"; final Context context= getbasecontext(); final PackageManager pm = context.getpackagemanager(); Intent appstartintent = pm.getlaunchintentforpackage(riktiga_vykort_package_name); if (null!= appstartintent) { context.startactivity(appstartintent); } else { Toast.makeText(context, "Could not find app: "+ RIKTIGA_VYKORT_PACKAGE_NAME, Toast.LENGTH_SHORT).show(); } 7
3. Att öppna appen Riktiga Vykort och skicka med en bild Normalt sett skickar du en länk till din bild med http:// följt av sökvägen till bilden, för att istället skicka bilden till appen Riktiga Vykort så ersätter du http:// med posten-rv:// istället. Efter sökvägen kan du skicka med parametrar som låter dig styra hur bilden ska visas, mer om detta i nästa del. För att anropa Riktiga Vykort från en annan app och skicka med en bild: posten-rv://url.to.your/photo.jpg?id= your.package.name&appname=your_appname&icon=http://url.to.your.app_icon/57x57.j pg&title= Fin utsikt över staden Barcelona&author=Karl Johansson Innan denna skickas måste länken formatteras: String formattedurl = URLEncoder.encode(unformattedURL, "UTF-8"); För att sedan skicka vidare länken till appen Riktiga Vykort: Intent i = new Intent(Intent.ACTION_VIEW, Uri.parse(formattedURL)); startactivity(i); 4. Parametrar som skickas med bilden id = Ditt paket namn, denna måste skickas med för att appen ska kunna läsa in bilden, samt att ditt id måste registreras innan användning. title = Titel på bilden (Skrivs ut på baksidan om inga andra titlar är definierade (titlese, titledk samt titleen) titlese = Svensk titel på bilden (Skrivs ut på baksidan om vykortet är adresserat till Sverige och Norge) titledk = Dansk titel (Skrivs ut på baksidan om vykortet är adresserat till Danmark) titleen = Engelsk titel (Skrivs ut på baksidan om vykortet är adresserat till annat land) author = Fotografens namn och/eller ägare av bilden. Max XX tecken. icon = Länk till appens ikon, ikonen skall vara 57x57 stor appname = Appens namn. Max XX tecken. 5. Knapp i egen app För de bilder som skall kunna skickas som vykort skall du lägga in en knapp som heter Vykort. För app med språkstöd engelska, Postcard. Knappen skall öppna en pop-up i din app enligt nedan. 8
6. Pop-up i egen app När användaren klickar på Vykorts -knappen skall en pop-up visas. I pop-up:en visas text samt ikonen för Riktiga Vykort. Ikon Riktiga Vykort Länken till ikonen som skall visas i pop-up https://posten.estarrebel.com/archive/images/iconriktigavykort.png OBS. Ikonen ändras över året, så lägg inte länken i en klass som cachar bilden utan ställ in så att appen alltid hämtar aktuell bild. Användaren har rätt version av appen Riktiga Vykort Användaren har fel version av appen Riktiga Vykort 9
Användaren har inte appen Riktiga Vykort 7. Riktiga Vykort i Google play Följande länk https://play.google.com/store/apps/details?id=se.posten.riktigavykort Baksidan på vykortet Utifrån inkomna parametrar så skrivs följande information ut på baksidan av vykortet: Vykort med mottagaradress till Sverige och Norge Vykort med mottagaradress till Danmark Vykort med mottagaradress till övriga världen 10