All API calls and HTTP methods require passing query parameters in headers including authorisation headers and API version information.
We do not allow query string in URL for any of our HTTP methods.
Authorization header is a mandatory parameter that has to be passed for almost every single call that you make to shopwave® API. To get an access token you must follow our Auth documentation
Authorization: <token_type> <access_token>
API version is not mandatory, but in order to get the latest API we would recommend you to send the specific version number on all API calls. You can do so by passing in request header:
Currently shopwave API only serves content in JSON format. Your application needs to accept JSON. It is not mandatory to pass the below parameter. But for log purpose we recommend you to pass it to us.
In order to maintain clean URL endpoints, you can pass GET query parameters through request headers with shopwave API. This can be done by simply passing key, value pair of request query parameters.
For POST request we allow multiple object in the same call it can be mixture of CREATE or UPDATE. There is of course limit for how many objects you can pass in one POST call. Currently the number is 200 and this number could change.
For all shopwave API responses you will get back a set of response headers. Most important once are listed below
Important! It is highly important that you check status code in all our responses. Our api messages will give you both success and errors and status codes is the one point reference to whether your request fully, partially or not succeded. If the request have multiple errors, the status code will be from the most severe one.
Most of our API response JSON object follow a certain pattern. The following JSON explains what you can expect in our response.
All our APIs contain clear and pinpoint messages to help you debug quickly. Shopwave server side execution millisecond is provided for you to measure performance. executionTime_milliSeconds is excluding network latency.