From an API point of view, our mobile email tests work exactly the same way as our regular email tests. Mobile email clients are simply additional 'Testing Applications’- you'll access them using the exact same API calls. The mobile results are returned amongst your regular email test results, and consist of URLs to the screenshots.
However, there is one crucial difference. Mobile email tests are interactive, in some cases, even animated. We use a handful of different image files, some CSS magic, and a touch of Javascript to achieve these results. In order to include these types of results in your application, you'll need to add our Javascript to your site, and load in our HTML/CSS code, rather than just the screenshot image. We've tried to make it as easy as possible for you to do- there is a full code sample to download below.
Code sample
Each mobile device requires different client-side (HTML/CSS/JS) code. Your application should check which mobile device is being viewed and serve up the appropriate client-side code. A list of mobile devices and their associated Application IDs can be found at the end of this document.
Sample HTML, CSS, Javascript as well as transparent devices images can be found at: https://github.com/litmus/litmus-mobile-samples
What are the Application IDs and OS details for these mobile devices?
| Phone Model | Operating System | Mail Client | Application ID |
|---|---|---|---|
| HTC Wildfire | Android 2.3 (Gingerbread) | Default | android23 |
| Samsung Galaxy Nexus | Android 4.2.2 (Jellybean) | Default | android4 |
| Samsung Galaxy Nexus | Android 4.2.2 (Jellybean) | Gmail App | androidgmailapp |
| Blackberry 8900 | Blackberry OS 5 (HTML) | Default | blackberryhtml |
| iPhone 4S | iOS 6 | Default | iphone4 |
| iPhone 5 | iOS 6 | Default | iphone5 |
| iPhone 5S | iOS 7 | Default | iphone5s |
| iPhone 6 | iOS 8 | Default | iphone6 |
| iPhone 6+ | iOS 8 | Default | iphone6plus |
| iPad (Retina) | iOS 7 | Default | ipad |
| iPad Mini | iOS 7 | Default | ipadmini |
| Nokia N96 | Symbian S60 | Default | symbians60 |
| Nokia Lumia 810 | Windows Phone 8 | Default | windowsphone8 |