Cisco Systems OL-5375-01 Identifying the Capabilities of IP Phone Clients, CiscoIPPhoneModelName

Chapter 5 HTTP Client Requests and Header Settings

Identifying the Capabilities of IP Phone Clients

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

•x-CiscoIPPhoneDisplay

•x-CiscoIPPhoneSDKVersion

x-CiscoIPPhoneModelName

This Cisco-proprietary header contains the Cisco manufacturing Model Name of the device, which can typically be found by going to Settings->ModelInformation, 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'')

	Cisco IP Phone Services Application Development Notes
5-66	OL-5375-01