To Next Page

To Previous Page

Getting Started Nur für den internen Gebrauch

A31003-S2000-R102-16-7620 02/2016

14 Provisioning Service, Developer’s Guide

c01.fm

Network Communication

1.4.4 HTTP/HTTPS Messages

Generally, two types of HTTP/HTTPS messages are used by the provisioning interface: XML

messages for phone control and data exchange, and HTML messages for initiating an interac-

tion by the provisioning service.

1.4.4.1 XML Messages For Data Exchange

Regular XML messages used for interactions between phone and provisioning service are

transmitted via HTTPS. The HTTP method is POST, and the Content-type is text/xml. The

structure of the XML messages is described in Section 3, "Basic Communication Procedures".

This is the structure of a URI for a request sent by the phone to the provisioning server:

https://<host>:<port>/<path to provisioning service>

Example: https://192.168.1.103:18443/provisioningService

1.4.4.2 Contact-me Messages

With this type of message, the provisioning service announces to the phone that it has a new

message for the phone.

Initial contact-me messages from the provisioning service are transmitted via non-encrypted

HTTP. The POST method is used. The HTTP Content-type is application/x-www-

form-urlencoded. The following parameters must/can be sent to the phone:

• ContactMe (required): Set to true if a response from the phone is expected.

• dls_ip_addr (optional): Target IP address for the response from the phone.

• dls_ip_port (optional): Port associated with the IP address provided with dls_ip_ad-

dr.

The parameters described above enable the provisioning service to scan a certain range of IP

addresses for phones simply by sending contact-me requests to each address consecutively.

The complete URI for contact-me messages has the following structure:

http://<IP address>:8085/contact_dls.html/ContactDLS

Example: http://192.168.1.4:8085/contact_dls.html/ContactDLS

The following examples show the HTTP communication initiated by a contact-me message.

The content-length of HTTPS responses should be set to the length of the XML mes-

sage content.

Unify OpenStage User Manual

Questions and Answers: