1.3 Protocol Overview (Synopsis)

This protocol enables programmatic access to view and manage the versions of files on the protocol server. It enables the retrieval of all versions of a file, the deletion of previous versions of a file, and the restoration of a file to a previous version. File versions are only generated when versioning is enabled.

Each method in the protocol is a SOAP operation that accepts a set of parameters as a SOAP request and returns a set of values as a SOAP response.

The protocol client sends a request to the protocol server via a SOAP request message, and the protocol server sends return values to the protocol client via a SOAP response message, as shown in the following figure. All SOAP requests are made to one of several well-defined URLs on the protocol server, which protocol clients can discover. The protocol server never initiates any communication with the protocol client.

Figure 1: SOAP message sequence