Kuaidi — бесплатный пакет расширения для поиска посылок

Данный проект больше не поддерживается, рекомендуется обратить внимание на новый проект: https://github.com/finecho/logistics

📦 Пакет объединяет интерфейсы поиска трёх служб доставки: «快递100», «快递网» и «快递鸟», и унифицирует способ их вызова.

❤️ Данный проект доступен на GitHub https://github.com/wi1dcard/kuaidi и Gitee (码云) https://gitee.com/wi1dcard/kuaidi.

Содержание

• Введение
• Использование
  • 0. Установка
  • 1. Создание накладной
  • 2. Поиск
  • 3. Получение данных
• Заключение
• Заявление

Введение

Примечание: в этом пакете расширения все названия компаний экспресс-доставки не заканчиваются словами «物流», «快递», «快运», «速递» или «速运».

Клонируйте этот репозиторий и выполните команду composer install для установки необходимых зависимостей.

Запустите в командной строке:

php examples/index.php <номер накладной> [название компании экспресс-доставки]

Здесь название компании экспресс-доставки можно опустить; результат будет следующим:

Использование

0. Установка

composer require wi1dcard/kuaidi

1. Создание накладной

$waybill = new \Kuaidi\Waybill(
    'номер накладной', 
    'название компании экспресс-доставки'
);

«快递100» поддерживает автоматическое распознавание, поэтому название компании экспресс-доставки указывать необязательно.

2. Поиск

(new \Kuaidi\Trackers\Kuaidi100)->track($waybill);
(new \Kuaidi\Trackers\Kuaidiwang)->track($waybill);
(new \Kuaidi\Trackers\Kuaidiniao('Business ID', 'APP Key'))->track($waybill);

Обычно достаточно выбрать один из трёх вариантов, рекомендуется использовать «快递100».

Если при поиске произошла ошибка или интерфейс вернул ошибку, будет выброшено исключение Kuaidi\TrackingException.

3. Получение данных

// Получение статуса, список всех статусов см. в константах Waybill::STATUS_*.
$waybill->getStatus();
// Получение подробной информации, можно напрямую использовать foreach / while / индекс массива.
$waybill->getTraces(); 

В реальных проектах можно самостоятельно написать вспомогательные функции для удобства использования.

Заключение

Целью этого пакета расширения было объединить различные интерфейсы поиска компаний экспресс-доставки, некоторые из которых были нестабильными или не поддерживали малоизвестные компании. Для продуктов компании требуется стабильность и высокая степень поддержки, поэтому был создан набор относительно унифицированных интерфейсов поиска, которые объединяют API различных компаний, а также облегчают дальнейшее расширение.

На данный момент он стабильно используется в производственной среде уже около трёх месяцев после удаления не относящихся к делу зависимостей и выпуска новой версии. Если у вас есть новые общедоступные интерфейсы или возникли проблемы с существующими, мы будем рады получить Issue и PR.

Что касается наименования, то, учитывая большие различия между внутренней и внешней средой, этот пакет расширения в основном используется только внутри страны; поэтому мы просто используем локализованные термины: Kuaidi.

Заявление

Интерфейсы получены из сети, и этот пакет расширения служит только для упаковки и сбора данных, предоставляя их только для обучения и справки; мы не гарантируем точность данных или доступность интерфейса; все юридические вопросы остаются на ваше усмотрение.