About Valigara API – Testing

About Valigara API

The Valigara API provides our clients a quick access to their data on Valigara.com.

The API is simple to use and in constant development, to make sure that our clients get the best integration with their systems.

Please contact us for the test account credentials.

Access & Authentication

The Valigara API is accessed using the link below, and the auth parameter:

https://api.valigara.com/client/V1/?auth={ACCESS_KEY}

The access key can be found in Dashboard -> My Account -> API tab

Requests

Requests are made using the action parameter.

Another optional parameter (specified in [ ] ) is data, which usually consists of JSON formatted information for the action.

https://api.valigara.com/client/V1/?auth={ACCESS_KEY}&action={ACTION_USED}[&data={DATA_USED}]

Any request must also contain the access key.

Actions are specified in the main API menu by category.

For large requests, it is recommended to use a POST request instead of a GET request.

Rate limiting

Some of api calls have rate limiting, in each call relevant limits will be described.
Rate limiting based on Leaky bucket algorithm.

HTTP headers (for limited actions only, i.e. “product_update_listings” only):

 

Output Format

The default output format is JSON, and it cannot be modified at the moment.

Standard Response

A standard response from the server consists of and array with status and data indexes. example:

A standard RAW response from the server example:

 

API Message Codes

100 OK
101 Non HTTPS call
102 Authentication Failed
103 Unauthorized Request
105 Rate limit exceeded

200 Action Not Found
201 Action Failed

300 Data Not Specified
301 Data Decode Failed
302 Partial Content in Data
303 Invalid Data

API Troubleshooting

Valigara API will return in response to your requests the http header “X-DEBUG-UID”. Please include its value (as text only) in all questions about your work with Valigara API. If Valigara will not return this header for some reason, please provide the raw http request & raw http response