README

PHP-клиент для работы с REST API управления контейнерами

Оглавление

1. Установка
2. Настройка
3. Использование
   • Работа с контейнерами
   • Загрузка фотографий
   • Справочники
4. Обработка ошибок
5. Разработка
6. Лицензия

Установка

composer require winolog/container-api-client

Настройка

Создайте .env файл:

CONTAINER_API_BASE_URL="https://api.container-service.com"
CONTAINER_API_LOGIN="your_login"
CONTAINER_API_PASSWORD="your_password"

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

Инициализация

use winolog\ContainerApiClient\ContainerApiClient;

$client = new ContainerApiClient();

Работа с контейнерами

Создание:

use winolog\ContainerApiClient\Dto\ContainerDto;

$container = new ContainerDto();
$container->container = 'TGHU1234567';
$container->container_year = 2023;
// ... другие поля

$response = $client->containers()->createContainer($container);

Справочники

Доступные справочники:

Примеры запросов:

// Получить все терминалы
$terminals = $client->references()->getTerminals();

// Получить типы контейнеров
$containerTypes = $client->references()->getContainerTypes();

// Получить модели холодильников
$coolerModels = $client->references()->getCoolerModels();

Загрузка фотографий

$response = $client->containers()->uploadContainerPhoto(
    123, // ID контейнера
    '/path/to/photo.jpg',
    'Описание фото' // необязательно
);

Обработка ошибок

try {
    $client->containers()->createContainer($container);
} catch (\winolog\ContainerApiClient\Exception\ApiException $e) {
    echo "Ошибка {$e->getCode()}: {$e->getMessage()}";
    if ($e->getResponseData()) {
        print_r($e->getResponseData());
    }
}

Разработка

1. Установите зависимости:

composer install

1. Запустите тесты:

composer test

Лицензия

MIT