Web Service Interface enables retreiving material from and importing material to Netvisor. The Web Service Interface resources are divided into upper level categories.

Common for all transactions:

  • Dates are in ANSI format
  • Country codes are always in ISO-3166 format
  • Attachments are always Base64 encoded in XML message
  • Empty elements don't need to be given in the XML message. For example in edit request the empty element is interprented as an order to delete the existing value
  • Compulsory elements should not be given empty in the XML message
  • Elements have to be in the same order as in the DTD

To be able to import Scandinavian characters (Ä, ä, Ö, ö or Å, å) the message has to be endcoded in UTF-8 but xml declaration does not need to be given. The message should always start with <root>.

Send one message at a time and wait for Netvisor's Web Service Interface to respond before you send the next message. Overlapping messages to the same customer environment cause different errors in customer environments.

We recommend the timeout for messages is at least 360 000 ms. This helps in avoiding unnecessary errors. Make large retreives and imports outside office hours if there is no special need to do these during that time. The frequency for transfers varies from resource and use case. In many cases transfers once a day or month is sufficient. You can speed up the transfers with appropriate limitations using resource parameters.

Interpretation instruction

Enclosed is a description of different entries and their meaning and interpretation in  Netvisor's Web Service Interface. The XML structure of different messages is descibed in tables for the part it is possibel and logic. Due to the XML structure, the resource descriptions have references to different parts of the instructions to be able to keep the entity as clear as possible.

The basic structure of resource description is the following:

Query:

  • Basic data
    • The used resource
    • GET - generally retreiving data from Netvisor
    • POST -generally posting data to Netvisor
  • Parameters
    • Usually defined in the QueryString, separated from the actual resource with ? and after the parameter there is &
  • XML structure when importing data (POST)
    • Described is the XML structure and e.g. the amount of different elements and their compulsion

Response:

Every query is answered with an XML response. The structure of the response matches the query for the most part and the general structure can be seen here. The response to GET type queries includes resource specific data structure that is described in each resource description. Depending on the POST type query, Netvisor Web Service Interface returns Replies element that can include e.g. InsertedDataIdentifier element with added item's NetvisorID.



Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.