guhemama/correios_api

此包已被弃用,不再维护。未建议替代包。

巴西邮政服务Correios的Web服务包装器

v1.0.2 2016-11-30 14:24 UTC

This package is not auto-updated.

Last update: 2022-12-23 15:50:58 UTC


README

Build Status Scrutinizer Code Quality Code Coverage Made With Love

CorreiosAPI是一个小的包装器,可以让您查询Correios跟踪Web服务,而无需了解其复杂性(并且不需要触摸XML! ;)。

要求

  • PHP >= 5.6
  • curl

安装

使用Composer安装它

composer require guhemama/correios_api

用法

您需要有效的凭据才能使用Correios Web服务。如果您没有这些凭据,可以使用像CorreiosTracker这样的服务。

use CorreiosAPI\Tracker;

$tracker = new Tracker('username', 'password');

try {
  $response = $tracker->track('DU030746105BR');
} catch (\InvalidArgumentException $e) {
  // An invalid tracking number will throw an exception
} catch (\RuntimeException $e) {
  // A HTTP error or XML parsing error will throw an exception
}

print_r($response);
/*
Array
(
  [DU030746105BR] => Array
  (
    [0] => Array
    (
        [when] => 10/12/2015 16:12
        [where] => CDD REBOUCAS - Curitiba/PR
        [action] => Entregue
        [details] => Objeto entregue ao destinatário
    )
    [1] => Array
    (
        [when] => 10/12/2015 10:10
        [where] => CDD REBOUCAS - Curitiba/PR
        [action] => Saiu para entrega
        [details] => Objeto saiu para entrega ao destinatário
    )
    [2] => Array
        (
            [when] => 10/12/2015 08:30
            [where] => CTE CURITIBA - Curitiba/PR
            [action] => Encaminhado
            [details] => Objeto encaminhado
        )
    [3] => Array
    (
        [when] => 08/12/2015 21:30
        [where] => CTE BELO HORIZONTE - BELO HORIZONTE/MG
        [action] => Encaminhado
        [details] => Objeto encaminhado
    )
    [4] => Array
    (
        [when] => 07/12/2015 17:14
        [where] => AC SHOPPING DIVINOPOLIS - Divinopolis/MG
        [action] => Encaminhado
        [details] => Objeto encaminhado
    )
    [5] => Array
    (
        [when] => 07/12/2015 13:57
        [where] => AC SHOPPING DIVINOPOLIS - Divinopolis/MG
        [action] => Postado
        [details] => Objeto postado
    )
  )
)
 */

许可证

版权所有 (c) 2014, Gustavo Henrique Mascarenhas Machado 所有权利保留。

在满足以下条件的情况下,允许重新分发和使用源代码和二进制形式,无论是否修改:

  • 源代码重新分发必须保留上述版权声明、本条件列表和以下免责声明。

  • 二进制形式重新分发必须在文档中或其他与分发一起提供的材料中复制上述版权声明、本条件列表和以下免责声明。

  • 未经具体事先书面许可,不得使用CorreiosAPI或其贡献者的名称来认可或推广由此软件派生出的产品。

本软件由版权所有者和贡献者按“原样”提供,不提供任何明示或暗示的保证,包括但不限于适销性和针对特定目的的适用性的暗示保证。在任何情况下,版权所有者或贡献者不对任何直接、间接、偶然、特殊、示范性或后果性损害(包括但不限于替代商品或服务的采购;使用、数据或利润的损失;或业务中断)承担责任,无论此类损害是否因本软件的使用或本软件使用导致的任何性质的侵权行为(包括疏忽或不作为)引起,即使已通知此类损害的可能性。