winolog/container-api

PHP client for Container Management API

dev-main 2025-08-02 18:22 UTC

Requires

• php: ^8.3
• ext-json: *
• guzzlehttp/guzzle: ^7.0
• vlucas/phpdotenv: ^5.4

MIT

• Ilya Klemin

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);

Справочники

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

Метод клиента	API Endpoint	Описание
getTerminals()	/terminals	Терминалы
getContainerSizes()	/container-sizes	Размеры контейнеров
getContainerTypes()	/container-types	Типы контейнеров
getCoolers()	/coolers	Холодильные установки
getCoolerModels()	/cooler-models	Модели холодильников
getCurrencies()	/currencies	Валюты
getSpecials()	/specials	Специальные параметры
getContainerQualities()	/container-qualities	Стандарты качества

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

// Получить все терминалы
$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