2.1.2 :: getMobileDevice

getMobileDevice



This function is an advanced version of isMobileDevice. Use this function to determine whether the device is a mobile device and also receive the model and manufacturer of the device.

Function:
getMobileDevice(devKey, headers)

Parameters:

  • devKey - used for authentication and to log usage.

  • headers - the headers of the device you wish to query.



Returns: (string)
Upon success, XML containing mobile device information
Upon failure, error codes WAPL markup

Example SOAP Request


  1.  <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:WaplAPI">
  2.   <SOAP-ENV:Body>
  3.   <ns1:getMobileDevice>
  4.   <devKey>Wapple</devKey>
  5.   <deviceHeaders>
  6.   <deviceItem>
  7.   <name>HTTP_HOST</name>
  8.   <value>wapple.net</value>
  9.   </deviceItem>
  10.   <deviceItem>
  11.   <name>HTTP_USER_AGENT</name>
  12.   <value>Mozilla/5.0 (SymbianOS/9.2; U; Series60/3.1 NokiaN95/10.0.018; Profile/MIDP-2.0 Configuration/CLDC-1.1 ) AppleWebKit/413 (KHTML, like Gecko) Safari/413</value>
  13.   </deviceItem>
  14.   <deviceItem>
  15.   <name>HTTP_ACCEPT_CHARSET</name>
  16.   <value>utf-8</value>
  17.   </deviceItem>
  18.   <deviceItem>
  19.   <name>HTTP_ACCEPT_LANGUAGE</name>
  20.   <value>en; q=1.0, en, *; q=0.5</value>
  21.   </deviceItem>
  22.   <deviceItem>
  23.   <name>HTTP_ACCEPT_ENCODING</name>
  24.   <value>deflate,gzip</value>
  25.   </deviceItem>
  26.   <deviceItem>
  27.   <name>HTTP_REFERER</name>
  28.   <value>http://www.wapple.net/</value>
  29.   </deviceItem>
  30.   <deviceItem>
  31.   <name>HTTP_CACHE_CONTROL</name>
  32.   <value>max-age=259200</value>
  33.   </deviceItem>
  34.   <deviceItem>
  35.   <name>HTTP_CONNECTION</name>
  36.   <value>keep-alive</value>
  37.   </deviceItem>
  38.   <deviceItem>
  39.   <name>HTTP_ACCEPT</name>
  40.   <value>application/vnd.phonecom.mmc-xml, application/vnd.wap.wmlc;type=4365, application/vnd.wap.wmlscriptc, application/vnd.wap.xhtml+xml, application/xhtml+xml;profile="http://www.wapforum.org/xhtml", image/bmp, image/gif, image/jpeg, image/png, image/vnd.wap.wbmp, image/x-up-wpng, multipart/mixed, multipart/related, text/html, text/plain, text/vnd.wap.wml;type=4365, audio/midi, audio/qcelp, audio/vnd.qcelp, application/x-pmd, audio/mid, audio/x-midi, audio/x-mid, audio/mp4, audio/mp3, audio/mpeg4, video/mpeg4, video/mp4, application/vnd.oma.dd+xml, application/vnd.oma.drm.message</value>
  41.   </deviceItem>
  42.   </deviceHeaders>
  43.   </ns1:getMobileDevice>
  44.   </SOAP-ENV:Body>
  45.  </SOAP-ENV:Envelope>
Downloadlisting 2.1.2.a


Example SOAP Response


  1.  <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:WaplAPI">
  2.   <SOAP-ENV:Body>
  3.   <ns1:getMobileDeviceResponse>
  4.   &lt;wapple_response&gt;
  5.   &lt;mobile_device&gt;1&lt;/mobile_device&gt;
  6.   &lt;manufacturer&gt;Nokia&lt;/manufacturer&gt;
  7.   &lt;model&gt;N95-1&lt;/model&gt;
  8.   &lt;/wapple_response&gt;
  9.   </ns1:getMobileDeviceResponse>
  10.   </SOAP-ENV:Body>
  11.  </SOAP-ENV:Envelope>
Downloadlisting 2.1.2.b


PHP Example


Nb. The example below uses the native PHP soap extension in PHP. The code is for demonstration purposes only and should be modified for use in a production environment.
  1.  <?php
  2.  try {
  3.   $sClient = @new SoapClient('http://webservices.wapple.net/wapl.wsdl', array('connection_timeout' => 5));
  4.   $isMobile = false;
  5.  
  6.   if($sClient)
  7.   {
  8.   $headers = array();
  9.   foreach($_SERVER as $key => $val)
  10.   {
  11.   $headers[] = array('name' => $key, 'value' => $val);
  12.   }
  13.   // check if we are a mobile device
  14.   $params = array(
  15.   'devKey' => "YOUR-DEV-KEY",
  16.   'deviceHeaders' => $headers
  17.   );
  18.  
  19.  
  20.   $xml = simplexml_load_string($sClient->getMobileDevice($params));
  21.  
  22.   if (trim($xml->mobile_device) == 1)
  23.   {
  24.   echo '<pre>';
  25.   echo 'I AM A MOBILE DEVICE'."\n";
  26.   echo 'Manufacturer: '.trim($xml->manufacturer)."\n";
  27.   echo 'Model: '.trim($xml->model)."\n";
  28.   echo '</pre>';
  29.   }
  30.   else
  31.   {
  32.   echo '<pre>';
  33.   echo 'I AM A WEB BROWSER'."\n";
  34.   echo 'Browser: '.trim($xml->manufacturer).' '.trim($xml->model)."\n";
  35.   echo '</pre>';
  36.   }
  37.   }
  38.  
  39.  } catch (Exception $e){
  40.   // Add your own exception handling here
  41.  }
  42.  ?>

Contents

Served 96,510,978 API requests
Contact Us