ups-tracking-api-ruby.md

UPS Tracking API - Node.js

Use Node.js to track UPS shipments with UPS Tracking API.

Features

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

Installation

Installation is easy:

gem install trackingmore

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 UPS shipments.

Usage

Create a tracking (Real-time tracking):

  require  'trackingmore'

  TrackingMore.api_key = 'your api key'
  
  begin
    params  = {"tracking_number" => "802608005721255486","courier_code"=>"ups"}
    response = TrackingMore::Tracking.create_tracking(params)
    puts response
  rescue TrackingMore::TrackingMoreException => e
    puts "Caught Custom Exception: #{e.message}"
  rescue StandardError => e
    puts "Caught Standard Error: #{e.message}"
  end

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

require  'trackingmore'

TrackingMore.api_key = 'your api key'

begin
  params  = [{"tracking_number" => "1ZC6G8280303220451","courier_code"=>"ups"},{"tracking_number" => "1ZR8E2200404839077","courier_code"=>"ups"}]
  response = TrackingMore::Tracking.batch_create_trackings(params)
  puts response
rescue TrackingMore::TrackingMoreException => e
  puts "Caught Custom Exception: #{e.message}"
rescue StandardError => e
  puts "Caught Standard Error: #{e.message}"
end

Get status of the shipment:

require  'trackingmore'

TrackingMore.api_key = 'your api key'

begin
  # Perform queries based on various conditions
  # params  = {"courier_code"=>"ups"}
  # params  = {"tracking_numbers" => "1ZC6G8280303220451,1ZR8E2200404839077","courier_code"=>"ups"}
  params  = {"created_date_min" => "2023-08-23T14:00:00+08:00","created_date_max"=>"2023-08-23T15:04:00+08:00"}
  response = TrackingMore::Tracking.get_tracking_results(params)
  puts response
rescue TrackingMore::TrackingMoreException => e
  puts "Caught Custom Exception: #{e.message}"
rescue StandardError => e
  puts "Caught Standard Error: #{e.message}"
end

Update a tracking by ID:

require  'trackingmore'

TrackingMore.api_key = 'your api key'

begin
  params  = {"customer_name" => "New name","note"=>"New tests order note"}
  id_string = '9a2f732e29b5ed2071d4cf6b5f4a3d19'
  response = TrackingMore::Tracking.update_tracking_by_id(id_string, params)
  puts response
rescue TrackingMore::TrackingMoreException => e
  puts "Caught Custom Exception: #{e.message}"
rescue StandardError => e
  puts "Caught Standard Error: #{e.message}"
end