OCAPI Usage
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). |
Customization | You can customize OCAPI resources on server-side. |
Custom properties | You can get access to customer properties of business objects. |
Expansions | You can minimize network traffic and conserve server CPU usage by using a technique called expansion. |
ExportDataUnitsConfiguration | Document representing a configuration for the data units which a site export needs to identify what exactly should be exported. All unit types (site specific, global, ...) which should be exported need to be set to ‘true‘. Units set to 'false' are simply ignored with this version and can also be skipped. |
ExportGlobalDataConfiguration | Document representing a configuration for the global data units which should be exported. |
ExportSitesConfiguration | Document representing a configuration for the site specific data units which should be exported. |
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. |
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. |
Jobs: Global | You can run various global jobs. |
Jobs: System | Predefined jobs that can be called with an OCAPI request. |
JSONP | You can request that the server returns 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. |
Queries | You can use queries to be selective about data returned by OCAPI, which reduces network bandwidth. |
Resource Data formats | You can specify a preferred data format for resources (JSON or XML). |
Resource States | Resource States can be used for Optimistic Locking, which prevents collisions of concurrent requests, for example, the "lost update" problem. |
SearchIndexUpdatConfiguration | Configuration document for updating the search index. |
Session bridge | Allows seamless interaction between OCAPI and a session-based storefront. |
SiteArchiveExportConfiguration | Input document for site archive export system job. |
SiteArchiveImportConfiguration | Input document for site archive import system job. |
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. |