REST API Reference
Ecwid REST API allows your application to manage Ecwid store on behalf of an Ecwid user. Create products, update orders, delete a customer and many many more.
RESTful / oAuth2
Ecwid API is a RESTful API with oAuth2 authentication. As any RESTful service, Ecwid REST API use the standard HTTP codes in requests:
GETto read store data
PUTto update store data
POSTto create entries
DELETEto remove entries
HTTPS All requests are done via HTTPs. Requests via insecure HTTP are not supported.
UTF-8 Ecwid API works with UTF-8 encoded data. Please make sure everything you send over in API calls also uses UTF-8.
All data received from API and submitted to API is JSON, so the content type should be:
UTC Date/time values returned by Ecwid API are in UTC.
API Version This document describes Ecwid REST API v.3
API calls limits You are free to build your app with as many API calls as you need to make your service awesome for Ecwid merchants, but keep in mind the usage policy.
To protect us and our users from abusing, we strongly advise that you optimize your app code to make fewer API requests. For example:
- Cache store data locally if you need to use or display it many times in your app
- If you need to synchronize store data with your database, use Webhooks to get timely updates about changes in a store. More details: Webhooks
– To get multiple product details at once (knowing their
productIds), specify them in a corresponding filter –
productId. More details: Searching Products
- To get multiple order details at once (knowing their
orderNumbers), specify them in a corresponding filter –
orderNumber. More details: Searching Orders
We constantly monitor API activity and servers load on our side to make sure every application uses API properly. In case an app abuses Ecwid API by generating huge amount of requests every day, we’ll attempt to get in touch with the developer to talk about the issue.
Don’t worry, you will unlikely face such trouble and even if you do, we will advice on how to fix that. But of course, if the usage is high enough to significantly affect other users of the platform and you don’t react on our warnings, we can temporarily disable your application.
Q: How can I make the requests?
You can use any library or software (capable of making HTTP requests) you are familiar with.
To make a basic API request you will need to know:
- Ecwid Store ID
- Access token (private or public)
These details are provided at the end of the app installation in an Ecwid store. Ways to get them depend on the app you are using, see the Authentication section for more details.
Here are some resources we can recommend to get started:
- Making HTTP requests with cURL in PHP
- Making HTTP requests with cURL in terminal
- Making HTTP requests with wget in terminal
For testing out the API functionality we can also recommend using Ecwid API Playground.