Download the PHP package nomisoft/royal-mail-tracking-api without Composer
On this page you can find all versions of the php package nomisoft/royal-mail-tracking-api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nomisoft/royal-mail-tracking-api
More information about nomisoft/royal-mail-tracking-api
Files in nomisoft/royal-mail-tracking-api
Package royal-mail-tracking-api
Short Description A library to ease development when working with the Royal Mail Tracking API
License MIT
Homepage https://github.com/nomisoft/royal-mail-tracking-api
Informations about the package royal-mail-tracking-api
Royal Mail Tracking API
To be able to track items through the Royal Mail API you'll need to be a Royal Mail account holder and have approved access to the Tracking API through the Royal Mail developer portal at https://developer.royalmail.net/
Installation
Usage
You'll need the tracking reference number of the item you wish to retrieve details of as well as your Client ID, Client Secret and App ID (all available from the Royal Mail developer portal)
Single item summary
The response returned is an array containing a DateTime object, the status and summary text
Single item full history
The response returned is a multidimensional array. Each delivery status update contains a DateTime object, the location and the status
Multiple item summaries
The response returned is a multidimensional array with the tracking reference number as the key. Each item contains a DateTime object, status and the summary
Proof of delivery
The response returned is an array containing a DateTime object and the name of the person that signed for the parcel
Errors
A RoyalMailException Exception is thrown if an error response is received from the API. Calling the getMessage() function will return Royal Mail's error description. There's also an additional getCause() function which will return the value of the 'Cause' field returned by the API
If the item was delivered over 30 days ago you might see the following printed from the above sample code