ctt-tracking-api-python.md

CTT Tracking API - Python

Use Python to track CTT shipments with CTT Tracking API.

Features

• Real-time CTT tracking.
• Batch CTT tracking.
• Other features to manage your CTT 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 CTT shipments.

Usage

Create a tracking (Real-time tracking):

  import trackingmore
  trackingmore.api_key = 'your api key'
  
  try:
    params = {'tracking_number': '0301006785462006320995','courier_code':'ctt'}
    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': 'LK201223662AU', 'courier_code': 'ctt'},
    {'tracking_number': 'LH290032509AU', 'courier_code': 'ctt'}
  ]
  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': 'ctt'}
  # params = {'tracking_numbers': 'LK201223662AU,LH290032509AU', 'courier_code': 'ctt'}
  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 = "9a1339cb81ec08b52985867d176a0ba4"
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)