TOP

APIs / Webservices

Welcome to the documentation for the WineDirect APIs / webservices. 

Versions

We have improved our APIs over time. We recommend that you use the latest version of each service whenever possible. Major versions we currently support are:

Each major version may have minor versions with marginal improvements. For ease of use, we will only document the latest minor version. If you are using an earlier version and have questions, please contact customer service.

Webservice Accounts

If you wish to set up a webservice account, an admin of the website must set up the account and agree to the terms of use. You can set up the account in the WineDirect admin panel, learn how to here »

General Information

Each web service is bundled into a module related to the type of data it’s manipulating. E.g. there are separate services for Contacts, Orders etc.

The objects used in the web service rely heavily on inheritance. As such, every request object will contain a username and password string. Every “Get” response will contain an isSuccessful flag, record count, a message if there is an error, and a collection of objects where appropriate. Every “upsert” response will contain a collection of result objects, one for each object pushed up, made up of an isSuccessful flag, an external key code that will match the ID in your system, an internal key code that will match the ID in the Vin65 system, and a message if there was an error.

Also, all "Get" response objects inherit from their respective "Upsert" request objects. So the objects returned from a "get" request are a combination of the "upsert" request and a "get" response as described in the sections in this documentation. The information is not duplicated in this document.

All additional parameters outside of the base objects are outlined on the pages on the left. A description is only provided for fields that are not obvious.

Please note:

  • The date/time stamps for Version 2.0 webservices are Pacific Standard Time, and Version 3+ webservices are in UTC time.
  • The webservices URLs for Australian clients differ from those for the US. Please see detailed pages for more info.
  • There is a brief daily service outage at 8 am EST / 5 am PST in the US/Canada, and at 11 pm AWST / 1 am AEST in Australia/New Zealand.

Page Top