yurcrm/pravoved-api

Pravoved.ru API client

v1.2.1 2022-11-26 12:22 UTC

Requires

• php: ^7.2 || ^8.0
• ext-curl: *
• ext-json: *

Requires (Dev)

• phpunit/phpunit: 8.1.0

MIT

• Michael Krutikov

README

Неофициальная библиотека для работы с API сервиса myleads.feedot.com.

Внимание: автор никак не связан с компанией Правовед. Библиотека была создана для интеграции моего проекта с сервисом и поставляется "Как есть".

Документация по API: https://myleads.feedot.com/api-doc/

Возможности:

• Получение авторизационного токена
• Получение списка предзаказов
• Получение лидов из предзаказа

Требования:

• PHP 7.2+
• Модули Curl и Json
• Аккаунт в сервисе Правовед

Установка через Composer

composer require yurcrm/pravoved-api

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

Перед началом использования убедитесь, что вы зарегистрированы в сервисе Правовед и вам включен доступ к API (в моем случае он был включен автоматически для 2 клиентов из 2)

Получение токена для работы с API

$pravovedClient = new PravovedApi\PravovedApiClient();
// $email и $password - ваши данные доступа к Правоведу
$pravovedClient->setEmail($email); 
$pravovedClient->setPassword($password);

try {
    $token = $pravovedClient->getAuthToken();
} catch (\Exception $e) {
    // обработка неудачной аутентификации
}

Получив токен, вы можете использовать его в следующих запросах

Получение списка предзаказов

// $token - ваш токен
$pravovedClient = new PravovedApi\PravovedApiClient($token);
try {
    $preorders = $pravovedClient->getPreorders();
} catch (\Exception $e) {
    // обработка ошибки получения предзаказов
}
// задержка между запросами для обхода ограничения на частоту запросов
sleep(60 / PravovedApiClient::MAX_FREQUENCY);

// получение только активных предзаказов
$activePreorders = $pravovedClient->filterActivePreorders($preorders);

Получение списка лидов предзаказа

foreach ($activePreorders as $activePreorder) {

    $preorderId = $activePreorder['id'];

    try {
        sleep(60 / PravovedApiClient::MAX_FREQUENCY);
        // Получим 50 последних лидов предзаказа
        $leadsFromPravoved = $pravovedClient->getPreorderLeads($preorderId, 50);
    } catch (\Exception $e) {
        // обработка ошибки получения лидов
    }
}

Контакты

Отзывы и предложения жду по адресу: [e-mail]