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.