Polycom 3725-49106-001 Rev A User Manual

Web Application for Polycom Phones 

UC Software 5.0.0

 

Polycom, Inc. 

23 

The HTTP URL push enables an application to push a URL to a phone to open its microbrowser or 
browser, as for example, an HTML Web page. The URL value sent within the push request is relative to 
the URL configured by the apps.push.serverRootURL configuration parameter. The pushed URL is 
appended to this root URL, and the microbrowser or browser attempts to open the pushed URL. This 
feature is asynchronous; and once the push request is received by the phone, it returns a 2xx or 4xx 
response immediately. There is no success/failure feedback for the push handling, and the pushing 
application does not know if the microbrowser or browser was able to open the pushed URL. 

Use the following format when configuring the HTTP URL Push: 

<URL priority=”X” >URI path</URL> 

When pushing data to a phone, make sure to send the request to:  

http://<Phone IP>/push 

. 

The URL push requests support the attributes listed in the following table. 

Sets the priority of the push, which determines how and when the URL is requested. For more information, refer to 

. 

Any relative URI (or relative URI path) on the configured application server. 

1

 If attribute is absent, Normal is used. 

2 

Currently multiple URIs in a single push request are not supported. 

 

 

The <URL> tag must be defined under a <PolycomIPPhone> root tag. For example: 

<PolycomIPPhone> 
    <URL priority=”Normal”>/examples/media.xhtml</URL> 
</PolycomIPPhone> 

 

The following table describes the results of using a specific priority when the phone is in different states. 

Idle State 

Critical 

The phone will display push request immediately. 

High 

The phone will display push request immediately.