china-post-tracking-api-php.md

China Post Tracking API - PHP

Use PHP to track China Post shipments with China Post Tracking API.

Features

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

Installation

Installation is easy:

$ composer require trackingmore/trackingmore-sdk-php

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 China Post shipments.

Usage

Create a tracking (Real-time tracking):

  require('vendor/autoload.php');

  use Trackingmore\TrackingMoreException;
  use TrackingMore\Trackings;
    
  $key = 'your api key';
  $response = null;
  $trackings = new Trackings($key);
  
  try {
    $params = ['tracking_number'=>'EE950677712TW','courier_code'=>'china-post'];
    $response = $trackings->createTracking($params);
  } catch (TrackingMoreException $e) {
    echo $e->getMessage();
  }

  print_r($response);

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

    require('vendor/autoload.php');

    use Trackingmore\TrackingMoreException;
    use TrackingMore\Trackings;
    
    $key = 'your api key';
    $response = null;
    $trackings = new Trackings($key);
    
    try {
        $params = [
            ['tracking_number'=>'RG022754039CN','courier_code'=>'china-post'],
            ['tracking_number'=>'AM247540919CN','courier_code'=>'china-post']
        ];
        $response = $trackings->batchCreateTrackings($params);
    } catch (TrackingMoreException $e) {
        echo $e->getMessage();
    }
    
    print_r($response);

Get status of the shipment:

require('vendor/autoload.php');

use Trackingmore\TrackingMoreException;
use TrackingMore\Trackings;

$key = 'your api key';
$response = null;
$trackings = new Trackings($key);

try {
    $params = ['courier_code'=>'china-post','created_date_min'=>'2023-08-23T06:00:00+00:00','created_date_max'=>'2023-09-05T07:20:42+00:00'];
    $response = $trackings->getTrackingResults($params);
} catch (TrackingMoreException $e) {
    echo $e->getMessage();
}

print_r($response);

Update a tracking by ID:

require('vendor/autoload.php');

use Trackingmore\TrackingMoreException;
use TrackingMore\Trackings;

$key = 'your api key';
$response = null;
$trackings = new Trackings($key);

try {
    $params = ['customer_name'=>'New name','note'=>'New tests order note'];
    $idString = '99e6cc563ad7533c56262b104007e751';
    $response = $trackings->updateTrackingByID($idString,$params);
} catch (TrackingMoreException $e) {
    echo $e->getMessage();
}

print_r($response);