Skip to content

Latest commit

 

History

History
103 lines (75 loc) · 2.92 KB

royal-mail-tracking-api-python.md

File metadata and controls

103 lines (75 loc) · 2.92 KB

Royal Mail Tracking API - Python

Use Python to track Royal Mail shipments with Royal Mail Tracking API.

Features

  • Real-time Royal Mail tracking.
  • Batch Royal Mail tracking.
  • Other features to manage your Royal Mail tracking.

Installation

Installation is easy:

$ pip install trackingmore-sdk-python

Quick Start

Get the API key:

To use this API, you need to generate your API key.

  • Click here to access TrackingMore admin.
  • Go to the "Developer" section.

  • Click "Generate API Key".

  • Give a name to your API key, and click "Save" .

Then, start to track your Royal Mail shipments.

Usage

Create a tracking (Real-time tracking):

  import trackingmore
  trackingmore.api_key = 'your api key'
  
  try:
    params = {'tracking_number': 'RF423511785GB','courier_code':'royal-mail'}
    result = trackingmore.tracking.create_tracking(params)
    print(result)
  except trackingmore.exception.TrackingMoreException as ce:
    print(ce)
  except Exception as e:
    print("other error:", e) 

Create trackings (Max. 40 tracking numbers create in one call):

import trackingmore
trackingmore.api_key = 'your api key'

try:
  params = [
    {'tracking_number': 'KL698957554GB', 'courier_code': 'royal-mail'},
    {'tracking_number': 'FL356951328GB', 'courier_code': 'royal-mail'}
  ]
  result = trackingmore.tracking.batch_create_trackings(params)
  print(result)
except trackingmore.exception.TrackingMoreException as ce:
  print(ce)
except Exception as e:
  print("other error:", e) 

Get status of the shipment:

import trackingmore
trackingmore.api_key = 'your api key'

try:
  # Perform queries based on various conditions
  # params = {'courier_code': 'royal-mail'}
  # params = {'tracking_numbers': 'KL698957554GB,FL356951328GB', 'courier_code': 'royal-mail'}
  params = {'created_date_min': '2023-08-23T06:00:00+00:00', 'created_date_max': '2023-09-05T07:20:42+00:00'}
  result = trackingmore.tracking.get_tracking_results(params)
  print(result)
except trackingmore.exception.TrackingMoreException as ce:
  print(ce)
except Exception as e:
  print("other error:", e) 

Update a tracking by ID:

import trackingmore
trackingmore.api_key = 'your api key'

params = {'customer_name': 'New name', 'note': 'New tests order note'}
id_string = "9a134772fec0a75ba36ed8162151eb87"
try:
  result = trackingmore.tracking.update_tracking_by_id(id_string, params)
  print(result)
except trackingmore.exception.TrackingMoreException as ce:
  print(ce)
except Exception as e:
  print("other error:", e)