Environments for Offers API

The Offers API have a number of environment running, some of which can be used to test integrations consuming the API.

Production environment

The production environment is meant to be used only for production queries, so please do not test against production.

The baseurl of the Offers API in production is https://offers.api.maersk.com/offers/ and the Offers API production version documentation reflects the actual version in production as the documentation is pushed through the environments together with the code changes.

We will do deploys to production environment without warning, but under normal circumstances the deploy will only disrupt the Offers API endpoints for a few seconds.

Integration testing (SIT) environment

The system integration testing environment is meant to be used to test against during development of changes to the application consuming the Offers API. Please do not use this environment for performance testing under a heavy load as it will not reflect actual production performance.

The baseurl of the Offers API in the system integration testing environment is https://offers.api-cdt.maersk.com/offers/ and the Offers API SIT version documentation reflects the actual version in SIT as the documentation is pushed through the environments together with the code changes.

We will regularly do deploys to the system integration testing environment without warning, and it will normally disrupt the Offers API endpoints in the environment for a couple of minutes.

Performance testing (SPT) environment

The SPT environment is meant to be used for performance testing with larger loads. We try to keep the performance of the environment close to actual production performance. Before running a performance test please let us know by contacting the support team (see Onboarding Guide for contact information). This is important because it is the only way we can coordinate your activities with activities of other consumer and/or internal changes. For example it would be unfortunate if we accidentally disrupt your long running performance test with a new deploy in the middle of it.

The baseurl of the Offers API in SPT environment is https://offers.api-stage.maersk.com/offers/ and the Offers API production version documentation reflects the actual version in SPT as the documentation is pushed through the environments together with the code changes.

We will do deploys to the performance testing environment without warning (unless we are aware of a scheduled performance test by internal or external consumers). A deploy will normally disrupt the Offers API endpoints in the environment for a couple of minutes.

Disruptions during deployment

During the deployment of a new version of the Offers API, a request to an endpoint will return a 502 Bad Gateway http status response.

Disruptions caused by downstream systems

The Offers API endpoints are consuming other Maersk APIs in order to provide the consumer with relevant data for the offers. This unfortunately means that sometimes the Offers API endpoints service in testing environments are disrupted by downstream APIs being offline or misbehaving. Normally when this happens the Offers API will return a 500 Internal Server Error. These APIs are outside our control and we can not always make sure that they for example don't disrupt an ongoing performance test. If this happens please reach out to our support team (see Onboarding Guide for contact information).