c01.fm
A31003-S2000-R102-16-7620, 02/2016
Provisioning Service, Developer’s Guide
15
Nur für den internen Gebrauch
Getting Started
Network Communication
Contact-me Message Example
POST /contact_dls.html/ContactDLS HTTP/1.1
Content-type: application/x-www-form-urlencoded; charset=utf-8
User-Agent: Jakarta Commons-HttpClient/2.0final
Host: 192.168.1.103:8088
Content-Length: 14
ContactMe=true
Phone Response to Contact-me Example
The phone sends a corresponding HTTP response. The HTTP status is
204
(no content). The
HTTP
Content-type
is
text/html
.
HTTP/1.1 204 No Content
Server: DlsClient
Content-Length: 0
Content-type: text/html
1.4.4.3
Polling Request To Bridge A Firewall
When the provisioning service is located behind a firewall, or in a DMZ, it may have no possi-
bility to send a contact-me message to the phone. To enable provisioning service driven inter-
actions despite this limitation, the phone can be configured to periodically poll the provisioning
service, or a special proxy, for new messages. This configuration is done by the provisioning
service, for instance, at phone startup; for the relevant data items, see Section 6.1, "Provision-
ing Service Related".
The polling request is an HTTP GET request which contains a particular key/value pair to iden-
tify the phone. The key is
device-id
, and the value is the phone’s MAC address as a para-
meter. The structure is as follows:
http://<target address>/dcmp/contact-me?device-id=<MAC address>
Example:
http://provisioning.mycompany.com/dcmp/contact-me?device-
id=12:34:56:78:9a:bc