README

快递鸟快递查询接口封装，逐步完善中...

安装

$ composer require xin6841414/express_bird

配置

在 config/app.php 注册 ServiceProvider (Laravel 5.5 + 无需手动注册)：

'providers' => [
    // ...
    Xin6841414\ExpressBird\ExpressBirdServiceProvider::class,
],

创建配置文件：

$ php artisan vendor:publish --provider="Xin6841414\ExpressBird\ExpressBirdServiceProvider"

修改应用根目录下的 config/express_bird.php 中对应的参数即可。

使用

1. 在控制器中使用

namespace App\Http\Controllers;

use Xin6841414\ExpressBird\ExpressBird;  //注入时用
use Xin6841414\ExpressBird\Facades\ExpressBird;  //门面用



class TestController extends Controller
{
    
     public function index(ExpressBird $expressBird)  
     {
       
         $result1 = $expressBird->realTimeQuery('777424831256386', 'STO');
         $result2 = app('express_bird')->realTimeQuery('777424831256386', 'STO');
         $result3 = ExpressBird::realTimeQuery('777424831256386', 'STO');
#         //$result:  {
#  "EBusinessID" : "1363938",
#  "ShipperCode" : "STO",
#  "LogisticCode" : "777424831256386",
#  "Location" : "青岛市",
#  "State" : "3",
#  "StateEx" : "302",
#  "Traces" : [ {
#    "Action" : "302",
#    "AcceptStation" : "已签收，签收人凭取货码签收。，可关注“申通快递”官方微信公众号获取实时物流信息",
#    "AcceptTime" : "2026-07-09 11:36:42",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "412",
#    "AcceptStation" : "快件已暂存至菜鸟驿站，如有疑问请联系1386xxx589，如有取件码问题或找不到包裹等问题，请联系：快递员【18661653919】，投诉电话【053285294663】，营业时间【08:00-20:30】，可关注“申通快递”官方微信公众号获取实时物流信息",
#    "AcceptTime" : "2026-07-08 16:23:04",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "202",
#    "AcceptStation" : " 【青岛市】山东青岛李沧区东部公司 的快递员(张三/13800138000)正在为您派送，【物流问题无需找商家或平台，请致电（053285294663）或专属渠道95543更快解决】，可关注“申通快递”官方微信公众号获取实时物流信息",
#    "AcceptTime" : "2026-07-08 16:03:31",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "202",
#    "AcceptStation" : " 【青岛市】山东青岛李沧区东部公司 的快递员(张三/13800138000)正在为您派送，【物流问题无需找商家或平台，请致电（053285294663）或专属渠道95543更快解决】，可关注“申通快递”官方微信公众号获取实时物流信息",
#    "AcceptTime" : "2026-07-08 14:23:23",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "2",
#    "AcceptStation" : "【青岛市】快件已到达 山东青岛李沧区东部公司 ，【物流问题无需找商家或平台，请致电（053285294663）或专属渠道95543更快解决】",
#    "AcceptTime" : "2026-07-08 14:22:32",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "2",
#    "AcceptStation" : "【青岛市】快件已发往 山东青岛李沧区东部公司，【物流问题无需找商家或平台，请致电专属渠道95543更快解决】",
#    "AcceptTime" : "2026-07-08 09:08:03",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "2",
#    "AcceptStation" : "【青岛市】快件已到达 山东青岛转运中心 ",
#    "AcceptTime" : "2026-07-08 08:51:14",
#    "Location" : "青岛市"
#  }, {
#    "Action" : "2",
#    "AcceptStation" : "【郑州市】快件已发往 山东青岛转运中心",
#    "AcceptTime" : "2026-07-07 20:54:27",
#    "Location" : "郑州市"
#  }, {
#    "Action" : "2",
#    "AcceptStation" : "【郑州市】快件已到达 河南郑州转运中心 ",
#    "AcceptTime" : "2026-07-07 20:51:55",
#    "Location" : "郑州市"
#  }, {
#    "Action" : "2",
#    "AcceptStation" : "【商丘市】快件已发往 河南郑州转运中心，若出现揽收后物流长时间未更新，请及时联系我们（【03702302699】或官方客服95543）核实，专属客服帮你跟进解决",
#    "AcceptTime" : "2026-07-07 15:33:56",
#    "Location" : "商丘市"
#  }, {
#    "Action" : "1",
#    "AcceptStation" : "【商丘市】河南夏邑县公司(03xxxx99)的出港扫描台(16xxxx798) 已揽收，若出现揽收后物流长时间未更新，请及时联系我们（【037xxxxx99】或官方客服95543）核实，专属客服帮你跟进解决",
#    "AcceptTime" : "2026-07-07 15:05:33",
#    "Location" : "商丘市"
#  } ],
#  "DeliveryManTel" : "13800138000",
#  "Success" : true
#}

        
     } 
 
}

其他接口陆续完善中...

对接进度

下单类接口
- 预约取件 oOrder
- 预约取件取消 cancelOrder
- 电子面单
  - 顺丰 eOrderSF
  - 邮政（含电商标快） eOrderEMS
  - 京东快递/快运2025（物流开放平台）
  - 中通冷链
  - 京东生鲜医药（物流开放平台）
  - 京东快递（JOS）
  - 中通快递
  - 云集医药冷链
  - 丰云配
  - 菜鸟橙运
  - 菜鸟速递
  - 菜鸟速运
- 电子面单取消 eOrderCancel
- 获取电子面单文件【顺丰】
- 获取电子面单追加子单【顺丰】
轨迹类接口
- 在途监控
  - 即时查询 realTimeQuery 注：40个自然日内同一（物流编码+单号）不限查询次数，计费1单；查询无轨迹不计费
  - 轨迹订阅
- 快递查询 expressQuery
- 物流查询地图版
  - 即时查询（地图版）
  - 轨迹订阅（地图版）
  - 地图url编辑

鸣谢

overtrue/easy-sms

xin6841414 / express-bird

Maintainers

Package info

Statistics

Security

README

安装

配置

使用

1. 在控制器中使用

其他接口陆续完善中...

对接进度

鸣谢