dongasai/kuaidi100

基于快递100,提供智能推送,云打印,短信服务

1.0.5 2023-08-29 07:02 UTC

This package is auto-updated.

Last update: 2024-08-27 05:21:37 UTC


README

本项目是从 harriescc/kuaidi100 分支的,感谢前辈,本分支将保持命名空间不变,并将添加个性化内容

composer require dongasai/kuaidi100

实现功能

- 实时查询
- 智能查询 (不推荐使用)
- 订阅推送
- 云打印

开始准备

快递100接口文档

实时查询

use HarriesCC\Kuaidi100\Tracker;

try {
    $kuaidi = new Tracker([
        'key' => '你的key',
        'customer' => '你的customer'
    ]);
    $kuaidi->track('快递公司编码', '快递单号');
} catch (Exception $e) {
    
}

智能查询(不建议使用,查询结果可能不准确)

use HarriesCC\Kuaidi100\Tracker;

try {
    $kuaidi = new Tracker([
        'key' => '你的key'
    ]);

    $kuaidi->getAutoTrack('快递单号');
} catch (Exception $e) {
    
}

订阅推送

use HarriesCC\Kuaidi100\Poll;

try {
    $kuaidi = new Poll([
        'key' => 'uexWYZbd2758',
    ]);

    $kuaidi->getPoll('快递公司编码', '快递单号', '回调地址', '返回格式');
    $kuaidi->getPollByParam([
        // 根据文档的param参数
    ], 'json');
} catch (Exception $e) {
    
}

云打印

use HarriesCC\Kuaidi100\CloudPrint;

try {
    $kuaidi = new CloudPrint([
        'customer' => '快递公司编码',
        'key' => '申请的key',
        'secret' => '分配的secret'
    ]);
} catch (Exception $e) {

}

云打印的sign

$kuaidi->getSign();

环境变量

请参考.env.bak文件,复制到.env

单元测试用例,实际使用时无需使用

  • KUAIDI100_KEY =
  • KUAIDI100_CUSTOMER =
  • KUAIDI100_SECRET =
  • KUAIDI100_USER_ID =

Docker

cd docker 

docker-compose --project-name kuaidi100 up -d

docker exec -it  kuaidi100-php72-1 bash

许可证

MIT