REST API

 

Welcome to the CPC REST API.

This is the root path for requests to the REST API. To find more information about available calls, check the API Version 2 or API Version 3 OpenAPI Specification.

Key Features of CPC API V3:

  • Supports Pagination
    • There are two parameters that are required for pagination –
    • offset: This indicates how many items should be skipped. If not specified, no items are skipped (same as offset=0).
    • limit: This indicates the maximum number of items to return. If not specified, a default value of 1000 is applied automatically.
    • For ex: returns at most 100 sales channels starting at the 100th: /saleschannels?offset=100&limit=100
  • Content Negotiation
    • API supports exposing response data in json as well as xml format.
    • To request data in xml, pass header 'accept: application/xml'. json is enabled by default.
  • V3 also provides date request parameter. Any data modified after the provided date will be returned. Date format is ISO yyyy-MM-dd’T’HH:mm:ss.SSSXXX — for example, “2000-10-31T01:30:00.000-05:00”
  • API contract differs widely between V2 and V3 – though context of the data and expectations remain the same. Please access swagger to see the contracts.
  • Consumers should still plan on persisting data at their end as was with prior versions of the API.
  • Basic domains [ Trees / Saleschannels / Groups & Products ] remain same / consistent with prior versions of API. Please note as-of-now, the V3 is not exposing any new data - data is same as V2 for most part.

API Documentation for V3:

All available endpoints are documented on OpenApi Specification.

Since this is OpenAPI specification, developers can download / save / import specification or import directly from the link in Postman or other tools of their choice.

The endpoints are secured and proper tokens are required to access them.