API v2.0 - /devices/detectall

Purpose Detect a Mobile, Tablet or Console. Can also perform a geoip look up. Usually a detection is called at the start of a session.
XML URI /devices/detectall.xml
JSON URI /devices/detectall.json
Parameters headers, options, a request
Returns message, status, class (Mobile, Console, Tablet, Unknown), plus option information for this device, or no information if this device cannot be found.

Note: class is only set if there are no errors.
Discussion - The thorny legacy issue We wanted to add the ability to detect iPads and Consoles. Problem is there is an expectation that the detect api call only provides information about handsets and when it cant provide information about a handset it returns 'Not Found'. Not Found means its most likely a browser. If detect suddenly started returning iPad or Console information we might break some folks websites that expect 'Not Found' to mean not mobile - and we didnt want that. So, we find ourselves with detectall. Our new workhorse for detections. detectall returns the same information as the detect call you've come to know and love accept it has an added class field which returns Unknown for unknown browser, Mobile for cell phone, Tablet for tablet devices (iPads and such) and Console for games consoles.


XML Example Request

<?xml version='1.0'?>
<request>
	<options>geoip, product_info, display</options>
	<User-Agent>Mozilla/5.0 (SymbianOS/9.2; U; Series60/3.1 NokiaN95/12.0.013; Profile/MIDP-2.0 Configuration/CLDC-1.1 ) AppleWebKit/413 (KHTML, like Gecko) Safari/413</User-Agent>
	<x-wap-profile>http://nds1.nds.nokia.com/uaprof/NN95-1r100.xml</x-wap-profile>
	<site>38</site>
</request>


XML Example Reply

<?xml version="1.0" encoding="UTF-8" ?>
<reply>
	<message>OK</message>
	<status>0</status>
	<class>Mobile</class>
	<geoip>
		<country>France</country>
		<city>Arcueil</city>
		<countrycode>FR</countrycode>
		<region>A8</region>
		<latitude>48.8</latitude>
		<longitude>2.3333</longitude>
		<isp></isp>
		<company></company>
	</geoip>
	<product_info>
		<brand_name>Nokia</brand_name>
		<model_name>N95</model_name>
		<unique>1</unique>
		<ununiqueness_handler></ununiqueness_handler>
		<is_wireless_device>1</is_wireless_device>
		<device_claims_web_support>1</device_claims_web_support>
		<has_pointing_device>1</has_pointing_device>
		<has_qwerty_keyboard></has_qwerty_keyboard>
		<can_skip_aligned_link_row>1</can_skip_aligned_link_row>
		<uaprof>http://nds1.nds.nokia.com/uaprof/NN95-1r100.xml</uaprof>
		<uaprof2></uaprof2>
		<uaprof3></uaprof3>
		<nokia_series>60</nokia_series>
		<nokia_edition>3</nokia_edition>
		<device_os>Symbian OS</device_os>
		<mobile_browser>Nokia</mobile_browser>
		<mobile_browser_version></mobile_browser_version>
	</product_info>
	<display>
		<resolution_width>240</resolution_width>
		<resolution_height>320</resolution_height>
		<columns>15</columns>
		<max_image_width>240</max_image_width>
		<max_image_height>280</max_image_height>
		<rows>6</rows>
	</display>
</reply>


JSON Example Request

{
	"User-Agent" : "Amoi-A310\/Plat-F-VIM\/WAP2.0\/MIDP1.0\/CLDC1.0 UP.Browser\/6.2.2.7.c.1.102 (GUI) MMP\/1.0",
	"options" : "chtml_ui,xhtml_ui,cache,image_format,security,bearer,storage,object_download,drm,mms,j2me,flash_lite",
	"site" : "38"
}


JSON Example Reply

{
	"message" : "OK",
	"status" : "0",
	"class" : "Mobile",
	"chtml_ui" :
	{
		"chtml_display_accesskey" : false,
		"emoji" : false,
		"chtml_can_display_images_and_text_on_same_line" : false,
		"chtml_displays_image_in_center" : false,
		"imode_region" : "none",
		"chtml_make_phone_call_string" : "tel:",
		"chtml_table_support" : false
	},
	"xhtml_ui" : 
	{
		"xhtml_honors_bgcolor" : false,
		"xhtml_supports_forms_in_table" : false,
		"xhtml_support_wml2_namespace" : false,
		"xhtml_autoexpand_select" : true,
		"xhtml_select_as_dropdown" : false,
		"xhtml_select_as_radiobutton" : false,
		"xhtml_select_as_popup" : false,
		"xhtml_display_accesskey" : false,
		"xhtml_supports_invisible_text" : true,
		"xhtml_supports_inline_input" : true,
		"xhtml_supports_monospace_font" : true,
		"xhtml_supports_table_for_layout" : true,
		"xhtml_supports_css_cell_table_coloring" : true,
		"xhtml_format_as_css_property" : true,
		"xhtml_format_as_attribute" : true,
		"xhtml_nowrap_mode" : true,
		"xhtml_marquee_as_css_property" : true,
		"xhtml_readable_background_color1" : "#99CCFF",
		"xhtml_readable_background_color2" : "#FFFFFF",
		"xhtml_allows_disabled_form_elements" : true,
		"xhtml_document_title_support" : true,
		"xhtml_preferred_charset" : "iso8859",
		"opwv_xhtml_extensions_support" : true,
		"xhtml_make_phone_call_string" : "wtai:\/\/wp\/mc;",
		"xhtmlmp_preferred_mime_type" : "text\/html",
		"xhtml_table_support" : true,
		"xhtml_send_sms_string" : "none",
		"xhtml_send_mms_string" : "none",
		"xhtml_supports_file_upload" : false,
		"xhtml_file_upload" : "supported"
	},
	"cache" : 
	{
		"total_cache_disable_support" : false,
		"time_to_live_support" : false
	},
	"image_format" : 
	{
		"wbmp" : true,
		"bmp" : false,
		"epoc_bmp" : false,
		"gif_animated" : false,
		"jpg" : true,
		"png" : true,
		"tiff" : false,
		"transparent_png_alpha" : false,
		"transparent_png_index" : false,
		"svgt_1_1" : false,
		"svgt_1_1_plus" : false,
		"greyscale" : false,
		"gif" : true,
		"colors" : 256
	},
	"security" : 
	{
		"https_support" : true,
		"https_detectable" : false,
		"phone_id_provided":false
	},
	"bearer" : 
	{
		"max_data_rate":9,
		"wifi":false
	},
	"storage" : 
	{
		"max_deck_size":4096,
		"max_url_length_in_requests":0,
		"max_url_length_homepage":0,
		"max_url_length_bookmark":0,
		"max_url_length_cached_page":0,
		"max_no_of_connection_settings":0,
		"max_no_of_bookmarks":0,
		"max_length_of_username":0,
		"max_length_of_password":0,
		"max_object_size":0
	},
	"object_download" : 
	{
		"downloadfun_support" : false,
		"directdownload_support" : false,
		"inline_support" : false,
		"oma_support" : true,
		"ringtone" : false,
		"ringtone_3gpp" : false,
		"ringtone_midi_monophonic" : false,
		"ringtone_midi_polyphonic" : false,
		"ringtone_imelody" : false,
		"ringtone_digiplug" : false,
		"ringtone_compactmidi" : false,
		"ringtone_mmf" : false,
		"ringtone_rmf" : false,
		"ringtone_xmf" : false,
		"ringtone_amr" : false,
		"ringtone_awb" : false,
		"ringtone_aac" : false,
		"ringtone_wav" : false,
		"ringtone_mp3" : false,
		"ringtone_spmidi" : false,
		"ringtone_qcelp" : false,
		"ringtone_voices" : 1,
		"ringtone_df_size_limit" : 0,
		"ringtone_directdownload_size_limit" : 0,
		"ringtone_inline_size_limit" : 0,
		"ringtone_oma_size_limit" : 0,
		"wallpaper" : false,
		"wallpaper_max_width" : 0,
		"wallpaper_max_height" : 0,
		"wallpaper_preferred_width" : 0,
		"wallpaper_preferred_height" : 0,
		"wallpaper_resize" : "none",
		"wallpaper_wbmp" : false,
		"wallpaper_bmp" : false,
		"wallpaper_gif" : false,
		"wallpaper_jpg" : false,
		"wallpaper_png" : false,
		"wallpaper_tiff" : false,
		"wallpaper_greyscale" : false,
		"wallpaper_colors" : 2,
		"wallpaper_df_size_limit" : 0,
		"wallpaper_directdownload_size_limit" : 0,
		"wallpaper_inline_size_limit" : 0,
		"wallpaper_oma_size_limit" : 0,
		"screensaver" : false,
		"screensaver_max_width" : 0,
		"screensaver_max_height" : 0,
		"screensaver_preferred_width" : 0,
		"screensaver_preferred_height" : 0,
		"screensaver_resize" : "none",
		"screensaver_wbmp" : false,
		"screensaver_bmp" : false,
		"screensaver_gif" : false,
		"screensaver_jpg" : false,
		"screensaver_png" : false,
		"screensaver_greyscale" : false,
		"screensaver_colors" : 2,
		"screensaver_df_size_limit" : 0,
		"screensaver_directdownload_size_limit" : 0,
		"screensaver_inline_size_limit" : 0,
		"screensaver_oma_size_limit" : 0,
		"picture" : false,
		"picture_max_width" : 0,
		"picture_max_height" : 0,
		"picture_preferred_width" : 0,
		"picture_preferred_height" : 0,
		"picture_resize" : "none",
		"picture_wbmp" : false,
		"picture_bmp" : false,
		"picture_gif" : false,
		"picture_jpg" : false,
		"picture_png" : false,
		"picture_greyscale" : false,
		"picture_colors" : 2,
		"picture_df_size_limit" : 0,
		"picture_directdownload_size_limit" : 0,
		"picture_inline_size_limit" : 0,
		"picture_oma_size_limit" : 0,
		"video" : false,
		"video_real_media_8" : false,
		"video_real_media_9" : false,
		"video_real_media_10" : false,
		"video_3gpp" : false,
		"video_3gpp2" : false,
		"video_mp4" : false,
		"video_wmv" : false,
		"video_mov" : false,
		"video_max_frame_rate" : 0,
		"video_max_width" : 0,
		"video_max_height" : 0,
		"video_qcif" : false,
		"video_sqcif" : false,
		"video_preferred_width" : 0,
		"video_preferred_height" : 0,
		"video_df_size_limit" : 0,
		"video_directdownload_size_limit" : 0,
		"video_inline_size_limit" : 0,
		"video_oma_size_limit" : 0,
		"video_vcodec_h263_0" : false,
		"video_vcodec_h263_3" : false,
		"video_vcodec_h264" : "none",
		"video_vcodec_mpeg4" : false,
		"video_acodec_amr" : false,
		"video_acodec_awb" : false,
		"video_acodec_aac" : false,
		"video_acodec_aac_ltp" : false,
		"video_acodec_qcelp" : false
	},
	"drm" : 
	{
		"oma_v_1_0_forwardlock" : true,
		"oma_v_1_0_combined_delivery" : false,
		"oma_v_1_0_separate_delivery" : false
	},
	"mms" : 
	{
		"receiver" : false,
		"sender" : false,
		"mms_max_size" : 0,
		"mms_max_height" : 0,
		"mms_max_width" : 0,
		"built_in_recorder" : false,
		"built_in_camera" : false,
		"mms_jpeg_baseline" : false,
		"mms_jpeg_progressive" : false,
		"mms_gif_static" : false,
		"mms_gif_animated" : false,
		"mms_png" : false,
		"mms_bmp" : false,
		"mms_wbmp" : false,
		"mms_amr" : false,
		"mms_wav" : false,
		"mms_midi_monophonic" : false,
		"mms_midi_polyphonic" : false,
		"mms_midi_polyphonic_voices" : 0,
		"mms_spmidi" : false,
		"mms_mmf" : false,
		"mms_mp3" : false,
		"mms_evrc" : false,
		"mms_qcelp" : false,
		"mms_ota_bitmap" : false,
		"mms_nokia_wallpaper" : false,
		"mms_nokia_operatorlogo" : false,
		"mms_nokia_3dscreensaver" : false,
		"mms_nokia_ringingtone" : false,
		"mms_rmf" : false,
		"mms_xmf" : false,
		"mms_symbian_install" : false,
		"mms_jar" : false,
		"mms_jad" : false,
		"mms_vcard" : false,
		"mms_vcalendar" : false,
		"mms_wml" : false,
		"mms_wbxml" : false,
		"mms_wmlc" : false,
		"mms_video" : false,
		"mms_mp4" : false,
		"mms_3gpp" : false,
		"mms_3gpp2" : false,
		"mms_max_frame_rate" : 0
	},
	"j2me" : 
	{
		"j2me_cldc_1_0" : false,
		"j2me_cldc_1_1" : false,
		"j2me_midp_1_0" : false,
		"j2me_midp_2_0" : false,
		"doja_1_0" : false,
		"doja_1_5" : false,
		"doja_2_0" : false,
		"doja_2_1" : false,
		"doja_2_2" : false,
		"doja_3_0" : false,
		"doja_3_5" : false,
		"doja_4_0" : false,
		"j2me_jtwi" : false,
		"j2me_mmapi_1_0" : false,
		"j2me_mmapi_1_1" : false,
		"j2me_wmapi_1_0" : false,
		"j2me_wmapi_1_1" : false,
		"j2me_wmapi_2_0" : false,
		"j2me_btapi" : false,
		"j2me_3dapi" : false,
		"j2me_loctapi" : false,
		"j2me_nokia_ui" : false,
		"j2me_motorola_lwt" : false,
		"j2me_siemens_color_game" : false,
		"j2me_siemens_extension" : false,
		"j2me_heap_size" : 0,
		"j2me_max_jar_size" : 0,
		"j2me_storage_size" : 0,
		"j2me_max_record_store_size" : 0,
		"j2me_screen_width" : 0,
		"j2me_screen_height" : 0,
		"j2me_canvas_width" : 0,
		"j2me_canvas_height" : 0,
		"j2me_bits_per_pixel" : 0,
		"j2me_audio_capture_enabled" : false,
		"j2me_video_capture_enabled" : false,
		"j2me_photo_capture_enabled" : false,
		"j2me_capture_image_formats" : "none",
		"j2me_http" : false,
		"j2me_https" : false,
		"j2me_socket" : false,
		"j2me_udp" : false,
		"j2me_serial" : false,
		"j2me_gif" : false,
		"j2me_gif89a" : false,
		"j2me_jpg" : false,
		"j2me_png" : false,
		"j2me_bmp" : false,
		"j2me_bmp3" : false,
		"j2me_wbmp" : false,
		"j2me_midi" : false,
		"j2me_wav" : false,
		"j2me_amr" : false,
		"j2me_mp3" : false,
		"j2me_mp4" : false,
		"j2me_imelody" : false,
		"j2me_rmf" : false,
		"j2me_au" : false,
		"j2me_aac" : false,
		"j2me_realaudio" : false,
		"j2me_xmf" : false,
		"j2me_wma" : false,
		"j2me_3gpp" : false,
		"j2me_h263" : false,
		"j2me_svgt" : false,
		"j2me_mpeg4" : false,
		"j2me_realvideo" : false,
		"j2me_real8" : false,
		"j2me_realmedia" : false,
		"j2me_left_softkey_code" : 0,
		"j2me_right_softkey_code" : 0,
		"j2me_middle_softkey_code" : 0,
		"j2me_select_key_code" : 0,
		"j2me_return_key_code" : 0,
		"j2me_clear_key_code" : 0,
		"j2me_datefield_no_accepts_null_date" : false,
		"j2me_datefield_broken" : false
	},
	"flash_lite" : 
	{
		"flash_lite_version" : "",
		"fl_wallpaper" : false,
		"fl_screensaver" : false,
		"fl_standalone" : false,
		"fl_browser" : false,
		"fl_sub_lcd" : false
	}
}