Postman is a free cross-platform API client app that allows you to experiment easily with API requests using a friendly interface.
You can download Postman here for Mac, Windows or Linux. It is also recommended that you set up a free Postman account to enable easy sharing.
You can still use the Postman for Chrome extension, but this is deprecated, and It is therefore recommended that you download your preferred native O/S version.
The Delivery Options Postman collection is designed to supplement the use case examples given in the rest of this section. It should help you quickly visualise how the Delivery Options API functions and what it can offer. It shares a variety of API
GET calls that allow you to return options for a variety of use cases (e.g. next available carrier services that can fulfil Home deliveries to a specific postcode, or deliveries to collection points within a specific radius).
Downloading the Collection
You can download the collection by clicking the Run in Postman button below:
If you have already downloaded a previous version, you will be asked whether you wish to create a copy. You are advised to do this rather than overwrite any previous collection.
Before you can use the collection, you will need to:
Obtain a Delivery Options API
keyif you do not already have one. To request a key, contact your Metapack account manager here. Because the
keyis needed to run every call in the collection for your particular retailer, we have parameterised it so that you only need to enter it once.
Never share your
Learn the basics of Postman. There are also many useful YouTube video tutorials.
Familiarise yourself with the Delivery Options Basic Parameters and Extended Parameters, so that you can make a detailed test call and return some delivery options.
Your collection, once downloaded, should appear as an expandable series of
GET requests in the left hand pane, as shown below.
There is a separate folder within the collection for each optionType -
OWNSTORE. Each folder contains the recommended ways of returning options for deliveries to that
optionType (i.e. to a particular postcode (
HOME), pickup location (
PUDO) or 'Click and Collect' point (
OWNSTORE)). The use cases within each folder are suggested by the request names.
One request is not dependent on another, and so it is not appropriate to use the Collection Runner or to chain requests together. Simply run the individual requests that suit your particular operation to get an idea of the delivery options that can be returned.
Select a request from the left hand pane, to display the associated call in the middle pane, starting with
Where a variable value has been used, it is enclosed within double braces, e.g.
You need to enter the actual values for these variables in the Metapack Options Postman environment, which is available in the top right hand corner of the application and will have been imported alongside your collection:
You need to:
initial values, overriding any of the suggested values that you do not want to use, and entering any that are blank.
Click Reset All to set all the
You will need to reset some of the
current values after each call.
Once you have saved your parameters, click Send on the main Postman screen to make the call. The response will be returned under the Body in JSON format.
The requests in the collection are by no means exhaustive. If you have particular options that you would like to be added to the collection, please contact us.