Identifying the capabilities of ip phone clients, X-ciscoipphonemodelname, X-ciscoipphonedisplay – Cisco OL-5375-01 User Manual
Page 6
Chapter 5 HTTP Client Requests and Header Settings
Identifying the Capabilities of IP Phone Clients
5-66
Cisco IP Phone Services Application Development Notes
OL-5375-01
Identifying the Capabilities of IP Phone Clients
Because XML services are now supported across a wide range of
Cisco IP Phones, web application servers now need to identify the capabilities of
the requesting IP phone to optimize the content returned to the phone. For
example, if the requesting phone is a Cisco IP Phone 7960, which cannot support
color PNG images, the application server must be able to identify this and return
a grayscale CIP image instead.
The IP phone client request to send the relevant information from the IP phone to
the web server application includes three (3) HTTP headers:
•
•
•
x-CiscoIPPhoneModelName
This Cisco-proprietary header contains the Cisco manufacturing Model Name of
the device, which can typically be found by going to Settings->Model
Information, but varies between different models. Some examples of
manufacturing Model Names are CP-7960, CP-7960G, CP-7940G, CP-7905G,
and CP-7970G.
x-CiscoIPPhoneDisplay
This Cisco-proprietary header contains the display capabilities of the requesting
device with the following four parameters (listed in the order they appear):
•
Width (in pixels)
•
Height (in pixels)
•
Color depth (in bits)
•
A single character indicating whether the display is color (''C'') or grayscale
(''G'')