De Open movilforum wiki

API Java de consulta de características de terminales mediante WURFL

A continuación se describe la interfaz java de consulta de características de terminales usando WURFL (Wireless Universal Resource File). Para utilizar esta interfaz, las aplicaciones deberán realizar una petición http a:

http://open.movilforum.com/wurfl/viewdevice.jsp

Esta petición deberá contener los siguientes parámetros:

  * Para consultas utilizando el UserAgent:
        o ua_string = el UserAgent del navegador a utilizar
        o strict = método de búsqueda empleado, estricto o aproximado 
        
  * Para consultas mediante Marca y Modelo:
        o brandName = Marca del terminal en cuestión
        o modelName = Modelo del terminal en cuestión

Nota: el método de búsqueda empleado por defecto será el aproximado, tanto si omitimos el parámetro strict en la petición como si damos cualquier valor que difiera al de búsqueda estricta (strict=on).

Nota2: siempre que la Marca y/o Modelo buscados no aparezcan en la base de datos WURFL, se devolverán las características del terminal genérico.

La respuesta será un xml con las características del terminal consultado. Para ello, se ha definidio el siguiente DTD basado en el original de WURFL:

<!ELEMENT wurfl ( devices ) >

<!ELEMENT devices ( device+ ) > <!ELEMENT device ( group* ) > <!ATTLIST device id NMTOKEN #REQUIRED > <!ATTLIST device fall_back NMTOKEN #REQUIRED > <!ATTLIST device user_agent CDATA #REQUIRED > <!ATTLIST device actual_device_root CDATA #IMPLIED >

<!ELEMENT group ( capability+ ) > <!ATTLIST group id NMTOKEN #REQUIRED >

<!ELEMENT capability EMPTY > <!ATTLIST capability name NMTOKEN #REQUIRED > <!ATTLIST capability value CDATA #REQUIRED >