URI Format

The lgfapi URI structure is broken down into several components.

In general, lgfapi URIs following the following schema:

The first portion of the URI (protocol, domain, environment, and app) is consistent with the URL of the environment’s UI accessed via a web browser. The remaining pieces after “lgfapi” are specific to the lgfapi and designate the version and path to any child modules and/or resources.

Versioning

Lgfapi requires a version number in all URIs. The format is “v#’, starting with “v9” as the first release. New versions are created only for major releases of the Oracle WMS Cloud application, not for minor versions. For example, the release of WMS 9.0.0 included the lgfapi v9 release, but there will not be a new lgfapi version number with the release of WMS 9.0.1. However, the APIs will continue to be updated with new features and improvements along with the minor releases of WMS.

The purpose of version control is to give customers some ability to remain on their current integrations until they can complete any changes required to handle the newest lgfapi version. It is strongly encouraged that all customers use the latest version of lgfapi. Version control is a tool to assist with upgrades and testing, it is not meant to be used in production for extended periods of time. The previous versions of lgfapi will unavoidably become out of sync with newer versions of WMS, and eventually will no longer be compatible. Oracle will not make changes to previous versions of lgfapi in order to maintain expired functionality or compatibility. Therefore, it is always in the best interest to use the latest version. New API versions are planned approximately once a year. Older API versions will be supported approximately one year after a newer one is released.

lgfapi Modules

Lgfapi contains modules that can be utilized by customers. These are groupings of functionality that may have their own formats and requirements. For example, lgfapi’s “entity” module is designed to allow customers to examine and interact with OCWMS business resources from outside the application.

Resource Path

The final component to the URI is the resource path. This may take many different forms depending on the HTTP method and any module-specific requirements.

Optional Trailing Slashes

A trailing slash at the end of and lgfapi URIs is optional and does not affect functionality.