This API imitates EasySDI Shop REST Service

Authentication

Done via HTTP Basic Authentication header.
You can set username and password on this page.

Exceptions

In case something gets wrong, a non-200 status code with a XML message wil be returned.
XML structure: https://viageo.ch/xsd/extract/exception.xsd
For an example, please see here

Possible exception codes:

Code Message Explanation
400 Bad Request The input XML do not validates with XSD
401 Unauthorized Authentication failed
403 Forbidden You are trying to update a Product from another supplier
404 Not Found Product or Order was not found
405 Method not allowed You are trying to use an HTTP method this endpoint does not support.
409 Conflict The product you are trying to update is not waiting for data (maybe it was already updated?)
500 Internal Server Error See sdi:details for more details about the error.

GetOrders

Allow to fetch Orders pending data. Only Products in "automatic" mode are shown. Once fetched, products are locked in "waiting data" status.

Input

URL: https://viageo.ch/api/legacyOrder/extract.getOrders
Methods: GET, POST

Query parameters
readOnly optional, boolean, false by default Do not lock Products once readDo not lock Products once read
withAttachment optional, boolean, true by default Do not add return GeoData PDF snapshot and XML metadata
Request parameters
Request (body) parameters are ignored.

Output

Output follows this XSD: https://viageo.ch/xsd/extract/getorders.xsd
For an example, please see here

SetProduct

Allow to answer to a Product, which was in "waiting data" status. A Product can get an answer with a file (attached to the request), with a remote file (an URL) or be rejected. Estimation and pricing are not used anymore, they are ignored.

Input

URL: https://viageo.ch/api/legacyOrder/extract.setProduct
Methods: POST
Content-Type must be application/x-www-form-urlencoded

Query parameters
None
Request parameters
xml required An XML input, following this XSD: https://viageo.ch/xsd/extract/setproductparameters.xsd
file required in some cases only When answering data with a file, binary data

For examples, please see here

Output

Output follows this XSD: https://viageo.ch/xsd/extract/setproduct.xsd
For an example, please see here