WhereIsNow™ Web Service

WhereIsNow™ Data and Messages

We have produced a solution as simple as possible to help developers to quickly integrate WhereIsNow™ data in their applications.

Please check the WhereIsNow™ WSDL ( [1] - [4] ).

 

The Web Service:

• has only one available operation: WhereIsNow
• can be queried using both http and https
• contains two complex object:

• CurrentDocument: contains the current keys of the document. These keys are used to query WhereIsNow™

• applicationId: identifier of the software application which is sending the request, default value is 0. Used to help developers to solve problems in their applications.[Get a new application ID]
• publisherId: identifier of the Publisher who has registered the document in WhereIsNow™
• documentId: identifier of the document registered in WhereIsNow™ by the Publisher who is identified by publisherId
• versionId: the current version of the document

• UpdatedDocument: contains the list of child documents of the document identified by CurrentDocument. Actually the list contains only a document with the same publisherId and documentId values

• Document: contains all the information specific to the latest version of the document, included obviously the addresses where a client can find the document
• publisherId: identifier of the Publisher who has registered the document in WhereIsNow™
• documentId: identifier of the document registered in WhereIsNow™ by the Publisher who is identified by publisherId
• versionId: the latest version of the document
• versionDescription: all the information describing this version of the document are contained in this xml field.
  Please check the latest xsd to know what information is available.
• winUrl: the WhereIsNow™ page where you can redirect the client to get more or reserved information.
• urls: the list of Addresses where the client can find the latest version of the document.

• VersionUrl: contains all the specific information to one of the addresses of the latest version of the document

• url: the address where a client can find the document. If the address is reserved it contains a link to the WhereIsNow™ page where you can redirect the client to get the reserved information.
• addressDescription: all the information describing the address are contained in this xml field.
  Please check the latest xsd to know what information is available.
• reserved: if true, all this address information is reserved to registered users only.

To access reserved information the service must be called using an https connection and the password must be coded in SHA1 format.

The following table shows the response of the Web Service to requests received by http or https with or without credentials: