API Authorization
The data sent by Deante API is not publicly available data. Before downloading them, each user must have a previously created and assigned, unique API key.
To obtain an API key, contact the sales representative responsible for the region. For Polish users, a map of sales representatives can be found in the contact tab on deante.pl/contact, or you can contact Customer Service, tel: +48 42 714 30 31, e-mail: sprzedaz@deante.pl. For foreign users, contact the Export Department at +48 42 638 30 23, or e-mail: export@deante.pl.
Key types
When requesting the creation of an API key, specify whether the key should be responsible for transferring data in JSON or XML. A single key can be used to transfer data in only one format. It is possible for a single user to have several keys, or to change the version of a key. All such requests should be addressed to the relevant sales representative.
Key authorization
Downloading of data by the API begins when the corresponding link, which has a unique API key in it, is used. The keys are written in the form of a string of random characters, preceded by the phrase "deante-", for example. deante-123456789-ab12-3cd4-e567-fg8h9ij12. For the example of downloading product data, such a link would look as follows:
https://api.deante.pl/api/products?key=API_KEY
where in place of the phrase API_KEY you should enter your API access key. For the above example key:
https://api.deante.pl/api/products?key=deante-123456789-ab12-3cd4-e567-fg8h9ij12
The API may return an error for the following situations:
- Invalid key - when the system does not recognize the specified key, it will return the response 403. In case of such a situation, it is recommended to check whether there is a typo in the link or key.
- Inactive key - unused keys are automatically deactivated after a period of one year of inactivity. In this case, the system will return an 403 error and inform you that the key is inactive.
- Customer authorization error - each key is assigned to a single customer, at the time of deletion or deactivation of the customer from the Deante database, the key will also become unusable, in this case the system will return the status 403 and inform about the error in the assignment of the customer to the API key.
If there are problems, contact the relevant sales representative.
Default language
Using the above link, without specifying the language, will generate the API in the default Polish language. You can learn more about language versions in the section Locales