Compatibility endpoints

These endpoints aim to provide compatible endpoints to the deprecated api for a soft migration.

Prerequisites

All that is needed to switch is:

• changing the baseURL
  • old: api.reimo-shops.de/extranet/rest
  • new: api02.reimo-shops.de/api/extranet/rest
• have an active user in the new API gateway (only through Beta-user program or Support)
• make sure you use this route to get your API token: integration

INFO

The swagger displays the endpoints as greyed out and struck through. This is to underline that the endpoints are deprectated and will not be developed further. However you are still able to use them.

Preparation

To prepare your application for future endpoints we advise you the change the baseURL to: https://api02.reimo-shops.de/api and add the part /extranet/rest to your request.

Availabe endpoints

• /articles/{artnr}
• /articles/all_prices_and_amounts -> Explanation
• /articles/allArticles -> Explanation
• /articles/checkPrice/{artnr} -> Explanation
• /articles/images
• /dealers/pricelist/csv -> Explanation
  • if using the Swagger UI, see changes in authentication here: CSV Download
• /shopwareexport -> Explanation
• /shopwareexport/shorten -> Explanation

Differences in data handling

Fix for invalid articles and articles that are forever out of stock

The amount of articles returned by the compatibility endpoints is reduced. This is due to a filter that removes invalid article numbers and articles that are forever out of stock and cannot be ordered anymore.

Fix for duplicated article numbers

As explained in the documentation of the endpoint /shopwareexport articles might be grouped as variants into master articles.

• `deprecated API: In the deprecated API if an article is part of a master article it is later repeated as a non master article, resulting in data duplication.
• new API: In the new API the behaviour is fixed resulting in only one object per article number: Either as a variant in a master article or as a stand alone article. No duplicate entries for the same article number.