seka19/tracking-sdk-php

Tracking PHP SDK

1.0.3 2022-01-06 11:35 UTC

This package is auto-updated.

Last update: 2024-09-06 17:16:27 UTC


README

Trackingmore API 的 PHP SDK

官方文档

文档

## 初始化

if (!defined("TRACKING_AUTOLOADER_PATH")) {
    define("TRACKING_AUTOLOADER_PATH", __DIR__);
}
require_once(__DIR__ . "/Autoloader.php");
use Tracking\Api;

# Pass api key parameter
$api = new Api('you api key');

快速入门

  • 将 ApiKey 放入 Api 类的构造函数中
  • 所有返回值都是 Json 格式。
  • 实例化 Api 类后,可以使用其接口方法
  • 可以将 Api 实例的沙盒设置为 true 以启用沙盒模式: $api->sandbox=true;
  • 大多数 Api 参数接收多个跟踪号

获取 Trackingmore 中的快递公司列表

$response = $api->courier();

检测您账户中定义的哪些快递公司匹配跟踪号

$data = ['tracking_number': 'EA152563254CN']
$response = $api->detect($data);

将跟踪信息发布到您的账户

//Create single tracking numbers
$data = ["tracking_number" => "RP325552475CN", "carrier_code" => "china-post"];
//Create multiple tracking numbers
$data = [
    ["tracking_number" => "RP325552475CN", "carrier_code" => "china-post"],
    ["tracking_number" => "LZ448865302CN", "carrier_code" => "china-ems"],
];
$response =$api->create($data);

所有 API 方法和方法的连接摘要

#sandbox model
$api->sandbox = true;
# Get a tracking number of real-time query result data
//$data = ["tracking_number" => "UB209300714LV", "carrier_code" => "cainiao"];
//$response = $api->realtime($data);

# archive
$data = ["tracking_number" => "RP325552475CN", "carrier_code" => "china-post"];
$response = $api->archive($data);

# Get a list of all carriers
$response = $api->courier();

# Create a tracking number
$data = ["tracking_number" => "RP325552475CN", "carrier_code" => "china-post"];
$response = $api->create($data);

# Create multiple tracking numbers
$data = [
["tracking_number" => "RP325552475CN", "carrier_code" => "china-post"],
["tracking_number" => "LZ448865302CN", "carrier_code" => "china-ems"],
];
$response =$api->create($data);
//
# Get logistics information for a tracking number
$response = $api->get("RP325552475CN","china-post");

# Get logistics information for multiple tracking numbers
$data = ["tracking_number" => "RP325552475CN,LZ448865302CN"];
$response = $api->get($data);

# Modify other information of a tracking number
$data = ['num'=>"RP325552475CN",'carrier_code'=>"china-post","order_id" => "#1234"];
$response = $api->modifyinfo($data);

# Modify the information of multiple tracking numbers
$data = [
["tracking_number" => "RP325552475CN", "carrier_code" => "china-post", "order_id" => "#1234",],
["tracking_number" => "LZ448865302CN", "carrier_code" => "china-ems", "order_id" => "#5678",],
];
$response =  $api->modifyinfo($data);

# Modify the carrier code of a tracking number
$data = ["tracking_number" => "RP325552475CN", "carrier_code" => "china-post", "new_carrier_code" => "china-ems"];
$response =  $api->modifyCourier($data);

# Delete a tracking number
$response = $api->delete("RP325552475CN","china-post");

# Delete multiple tracking numbers
$data = [
["tracking_number" => "RP325552475CN", "carrier_code" => "china-post"],
["tracking_number" => "LZ448865302CN", "carrier_code" => "china-ems"],
];
$response = $api->delete($data);

# Set multiple tracking numbers no longer update
$data = [
["tracking_number" => "RP325552475CN", "carrier_code" => "china-post"],
["tracking_number" => "LZ448865302CN", "carrier_code" => "china-ems"],
];
$response = $api->notUpdate($data);

# Get status statistics of tracking ticket number
$data = ["created_at_min" => time() - 3600 * 24 * 30, "created_at_max" => time()];
$response = $api->status($data);

# Get user information
$response =  $api->user();

# Query whether remote
$data = [
["country" => "Japan", "postcode" => "7621094"],
["country" => "NZ", "postcode" => "Papaaroha"],
];
$response = $api->remote($data);

# Get the timeliness of multiple carriers
$data = [
["original" => "CN", "destination" => "US", "carrier_code" => "dhl"],
["original" => "CN", "destination" => "RU", "carrier_code" => "dhl"],
];
$response = $api->transitTime($data);

典型服务器响应

我们将响应以下状态代码之一。