Commerce Layer is proud to sponsor the JAMstack Conf, San Francisco — 29-30 October, 2018 🎉

Introduction

Commerce Layer exposes a fast REST API that lets you add ecommerce to your favorite tech stack. This guide is your reference for all the operations that you can perform on the API resources.

Base endpoint

All API requests must be made over HTTPS to the following base endpoint:

https://{{subdomain}}.commercelayer.io

The subdomain parameter is the unique subdomain of your organization. The rest of the documentation omits the base endpoint from all the example requests.

API Specification

Commerce Layer API is 100% compliant with the JSON API specification (v1.0). It supports compound documents, sparse fieldsets, resource linking, filtering, sorting, pagination and more. The JSON API community has shared some client libraries that can help you get started. Official libraries and SDKs for the most popular languages are coming soon.

Ruby developer? Check out our official ruby gem on Github.

Applications

Commerce Layer implements the industry-standard OAuth 2.0 protocol to manage clients authorization. It defines four types of applications:

Channel
Best suited to create storefront channels, like an ecommerce website or application.
Integration
Perfect to integrate any 3rd party system, like an ERP or a CRM, that needs custom permissions.
Zapier
Used to authenticate our official Zapier app (currently in beta) and to build any workflow.
Webapp
Used to authenticate users and access resources on their behalf.

Which application to use depends on your specific use case. Official guides and tutorials for the most popular use cases are coming soon.

Environments

For each organization, you can work either in test mode (default) or live mode. Working in test mode is free forever. You can try Commerce Layer in test mode as long as you need. Test mode also provides you with a development environment after the go-live. All API calls are identical between the two environments. Use test or live application credentials to make the switch.

Get our machine-readable JSON schema that follows the OpenAPI Specification (formerly Swagger).

Get our Postman collection in one click and start making real calls to Commerce Layer API in minutes.

Get in touch with our support team if you have any questions or want to learn more about Commerce Layer.