Filter
Top Products
Web Application for Polycom Phones UC Software 5.0.0
Polycom, Inc. 23
HTTP URL Push
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
See Configuring Push Request Parameters.
The URL push requests support the attributes listed in the following table.
Table 9: URL Push Request Attributes
Attribute
Permitted Values
priority
1
Critical, Important, High, Normal
Sets the priority of the push, which determines how and when the URL is requested. For more information, refer to
Table 10: How Priority Affects URL Push Requests.
URI path
2
String
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.
Note: Defining PolycomIPPhone Tags
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.
Table 10: How Priority Affects URL Push Requests
Phone State
Priority
Description
Idle State
Critical
The phone will display push request immediately.
High
The phone will display push request immediately.