OCAPI Usage 23.2

All Topics

Detailed information about using the Open Commerce API:

Topic Description
API Explorer You can interactively explore the Open Commerce APIs with API Explorer.
Batch requests You can sometimes use a batch request (a multipart HTTP request that can contain up to 50 subrequests) instead of issuing multiple separate requests.
Best practices Useful tips for working with OCAPI.
Caching You can build client-side application caches or leverage Proxy caches.
Client application identification You must ensure that your client application identifies itself for security and tracking purposes.
CORS You can take advantage of Cross-Origin Resource Sharing (CORS).
Custom properties You can get access to customer properties of business objects.
Customization You can customize OCAPI resources on server-side.
Data formats You can specify a preferred data format for resources (JSON or XML).
Expansions You can minimize network traffic and conserve server CPU usage by using a technique called expansion.
Filtering You can specify a filter on an API request to limit the number of items in the response.
Flash Document contains special information.
Global Exceptions Global exceptions thrown by OCAPI.
Global HTTP headers HTTP headers globally used by OCAPI.
Hook Circuit Breaker The Hook Circuit Breaker feature improves stability and saves processing time by protecting the system from high rates of hook failures.
Hooks Lists all API hooks available in this version.
HTTP methods You create requests based on standard HTTP methods (as defined by RFC 2616).
HTTP status codes and faults You can diagnose problems or failures by examining HTTP status codes and faults.
Images You can retrieve images using absolute URLs.
JSONP You can request that the server return a JSON document with a JavaScript function call wrapped around it.
JWT (JSON Web Token) The stateless Shop API uses JSON Web Tokens in its authentication mechanism.
Localization You can use the API in different locales.
Metadata You can request metadata about the API itself, such as the current version.
OAuth 2.0 You have to authorize your Data API requests using the OAuth 2.0 protocol.
OCAPI settings You can configure OCAPI settings in Business Manager by modifying a JSON data structure, enabling you to control client permissions, caching, and other resource-specific behaviors.
Optimistic locking Describes the two optimistic locking mechanisms supported by OCAPI.
Pagination You can use pagination to break up large responses into smaller chunks.
Property selection You can use property selectors to limit which resource properties are returned.
Resource States Resource States can be used for Optimistic Locking, which prevents collisions of concurrent requests, e.g. the "lost update" problem.
Session bridge Allows seamless interaction between OCAPI and a session-based storefront.
System Jobs Predefined jobs that can be called with an OCAPI request.
URL syntax You must create appropriately constructed URLs to operate on resources.
Versioning and deprecation policy You must ensure that your application conforms to the versioning and deprecation policy.
X OCAPI versions 15.x and 16.x will be retired on March 31, 2021. For dates and more information, see the OCAPI versioning and deprecation policy and this Knowledge Article.