README

Avito Laravel API PHP 客户端

本包是为Avito API设计的客户端，旨在简化Laravel应用程序与Avito平台的集成。它提供了一套工具来处理Avito API，允许您自动化和简化与列表管理、信息更新和统计信息获取相关的任务。

为什么使用API

Avito API通过允许您

• 自动化在Avito上执行的操作和动作。
• 将Avito与您的CRM系统、ERP系统（用于内容管理）、消息系统（用于客户沟通）或分析系统集成。
• 通过启用自动数据更新和获取统计数据来提高业务效率。

Avito API的功能

使用此客户端，您可以

• 与客户沟通：使用现成的集成或创建您需要的集成。
• 接收自动加载信息：获取自动加载成功和错误的数据。
• 更新价格和可用性：快速从您的系统更新Avito上的价格和可用性信息。
• 获取统计数据：分析您的列表效果并获得详细的统计数据。

每个类别（例如，Avito房地产或Avito工作）都有具体的API方法，请参阅Avito API文档。

要求

• PHP: ^8.3
• Laravel框架: ^11.0
• Spatie Laravel数据: ^4.9

在继续安装之前，请确保您的环境满足这些要求。

安装

您可以通过Composer安装Laravel Avito API客户端

composer require voyanara/avito-laravel-client

该包将自动注册服务提供者。

此包包含迁移文件和配置文件。您可以使用以下Artisan命令发布它们

php artisan vendor:publish --provider="Voyanara\LaravelApiClient\Infrastructure\Providers\AvitoModuleServiceProvider --tag="config"

php artisan vendor:publish --provider="Voyanara\LaravelApiClient\Infrastructure\Providers\AvitoModuleServiceProvider --tag="migrations"

这是将作为config/avito.php发布的配置文件的默认内容

使用方法

您有几种方法可以在Laravel应用程序中使用Avito API客户端

使用外观

要通过外观使用Avito API客户端，您可以直接在AvitoClient外观上调用方法。

示例

public function action(AvitoClient $client)
{
    $client::messenger()->getChats();
    //or
    AvitoClient::user()->self();
}

如果Laravel没有识别外观，您已经在composer.json中的extra > laravel > aliases下定义了它，请确保在您的文件中导入它

use Voyanara\LaravelApiClient\Application\Facades\AvitoClientFacade as AvitoClient;

使用依赖注入

或者，您可以使用依赖注入来访问Avito API客户端。如果您更喜欢将依赖项注入到您的函数或构造函数中，则建议使用这种方法。

use Voyanara\LaravelApiClient\Application\Facades\Client;

public function action(Client $client)
{
    $client->messenger()->getChats();
    //or
    $client->user()->getBalance();
    $client->user()->getOperationsHistory();
}