Skip to content

Latest commit

 

History

History
53 lines (42 loc) · 1.93 KB

File metadata and controls

53 lines (42 loc) · 1.93 KB

API changelog

v2 changes

2/12/2013

  1. Coupons API rolled out. This update gives an ability to create and manage coupons via API.
  2. GET Store settings via API. This update gives an ability to query store data via API.

Things that are different in v2 API compared to v1

Change

v1

v2

Requesting data

In v1, requesting store data was always a POST operation. The API credentials were sent as part of XML payload

In v2, basic auth is used for authentication. The API is RESTful, supports GET, POST, PUT and DELETE verbs

Resources

In v1, API methods were part of the XML payload. All request were directed to a single endpoint. The resource name was specified under GetOrders

In v2, the resources are specified by request uri

Response

In v1, XML was the only supported response

In v2, responses can be requested in JSON and XML

Errors

In v1, the errors were sent via XML payload with a node - STATUS that indicated failure

In v2, the errors comply with standard HTTP conventions as it is norm with REST APIs

Endpoint

In v1, the base url for API access was https://store.com/xml.php

In v2, the base url for API access is https://store.com/api/v2

Resources

In v1, the API supported products, orders and customers resources.

In v2, the API supports an extended set of resources.