instacar/autometrica-webservice-client

与 Autometrica Webservice 通信的 Web 服务客户端

v1.0.0 2022-03-15 18:49 UTC

README

Autométrica Webservice 的非官方实现。

注释

这个库与 Autométrica 没有任何关系和形式。它仅仅是一个衍生的作品,为了能够以简单、实用的方式通过 POPO (Plain Old PHP Objects) 模型使用 Autométrica Webservice。

安装

依赖项

这个库依赖于实现 PSR-18 接口的 HTTP 客户端。你可以按照以下方式安装这个实现的标准客户端:

composer require symfony/http-client

安装客户端很简单,只需执行以下命令:

composer require instacar/autometrica-webservice-client

使用方法

要使用客户端,你可以创建一个默认实例,该实例将负责创建 HTTP PSR-18 客户端。客户端为 Autometrica Webservice 的每个端点提供了一种方法。例如,为了请求车辆目录:

use Instacar\AutometricaWebserviceClient\AutometricaClient;

$cliente = AutometricaClient::createDefault($username, $password);
$catalogo = $cliente->getCatalog();

每个 Webservice 实体都由一个 PHP 类建模,该类为每个属性提供了 getter,旨在为 IDE 提供更好的帮助和自动完成功能,并为每个属性提供严格的数据类型。继续上述示例:

foreach ($catalogo as $vehiculo) {
    echo $vehiculo->getBrand(); // La marca del vehículo
    echo $vehiculo->getModel(); // El modelo del vehículo
    echo $vehiculo->getYear();  // EL año del vehículo
    echo $vehiculo->getTrim();  // La versión del vehículo
}

如果您想查看实现的方法和模型,请参阅文档。

高级

如果您想使用自己的 HTTP PSR-18 客户端实现,可以直接使用 HTTP 客户端实例化 AutometricaClient

use Instacar\AutometricaWebserviceClient\AutometricaClient;

$cliente = new AutometricaClient($clienteHttp, $username, $password);

许可证

这个库使用 Lesser General Public Licence Version 3 (LGPLv3)。您可以在 LICENSE 文件中查看。