landofcoder/trackingmore-php

Trackingmore PHP 库

1.0.0 2021-12-09 07:20 UTC

This package is auto-updated.

Last update: 2024-09-09 13:16:53 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 方法与所有 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);

典型服务器响应

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