Download the PHP package phpsoftbox/ozon without Composer
On this page you can find all versions of the php package phpsoftbox/ozon. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download phpsoftbox/ozon
More information about phpsoftbox/ozon
Files in phpsoftbox/ozon
Package ozon
Short Description Ozon API client component for the PhpSoftBox framework
License MIT
Informations about the package ozon
PhpSoftBox Ozon
О компоненте
phpsoftbox/ozon — PSR-18 клиент Ozon Seller API для PHP 8.5+.
Он отправляет запросы, добавляет авторизацию, обрабатывает ошибки и возвращает
OzonApiResponse (совместимый с Collection). По желанию ответ преобразуется
в типизированный DTO через makeDto().
Снимок Swagger от 2026-09-28 содержит 481 операцию — для каждой есть именованная обёртка. Полная карта методов и инструкция миграции содержит точные вызовы и изменения по снимкам: 14 операций добавлено 2026-09-28, 64 добавлено и 19 удалено 2026-09-14. Удаление старых методов и обновление моделей ответа требуют проверки потребителей.
Этикетки FBS: Ozon отключает 2.11.2026 postingFbsV1()->packageLabelCreate(),
postingFbsV1()->packageLabelGet(), postingFbsV2()->packageLabelCreate() и postingFbsV2()->packageLabel().
Замены — postingFbsV3()->packageLabelCreate() и postingFbsV2()->packageLabelGet(), у них другой
формат запроса и ответа: см. раздел о переходе.
Основные способы работы:
- предметные группы:
productV3(),postingFbsV4(),postingFboV3(),supplyOrderV2(),carriageV1(),cargoesV2(),reviewV2()и другие; - универсальные маршруты через
v1()...v6(),version()иrequest(); - явное преобразование ответа через
makeDto(); - настраиваемые повторы после серверного HTTP 429;
OzonExceptionс HTTP-статусом и данными ответа.
Новые обёртки принимают массив payload в формате Swagger без переименования полей. Не путайте версию метода Ozon в URL с версией PHP-пакета: старый endpoint сохраняется, пока он опубликован в используемом снимке.
Quick Start
Повтор запросов после HTTP 429
Клиент автоматически повторяет запрос после 429 Too Many Requests для всех
HTTP-методов. Повтор выполняется только после полученного ответа 429: сетевые ошибки,
timeout и другие HTTP-статусы этот механизм не перехватывает.
По умолчанию выполняется не более четырёх попыток, включая первоначальный запрос. Если Ozon не передал корректную задержку, используются 1, 2 и 4 секунды. Клиент понимает следующие заголовки:
Retry-After— секунды либо HTTP-date;Item-Retry-After— минуты до восстановления лимита операций с товарами.
Если в ответе присутствуют оба заголовка, клиент использует наибольшую задержку. Она также не может быть меньше fallback текущей попытки.
Чтобы синхронный worker не засыпал на длительный cooldown (Item-Retry-After задаётся
в минутах), по умолчанию действуют два бюджета:
- одна задержка — не более 30 секунд (
maxDelaySeconds); - сумма задержек одного вызова клиента — не более 60 секунд (
maxTotalDelaySeconds).
Задержка не обрезается до лимита: более ранний повтор противоречил бы заголовку. Вместо
ожидания клиент выбрасывает OzonException со статусом 429 и payload последнего ответа.
null в параметре отключает соответствующее ограничение.
Для каждой попытки создаётся новый body stream из сохранённого JSON. Поэтому полностью прочитанное предыдущим PSR-18 вызовом тело не влияет на следующий запрос.
Настройка retry
maxAttempts: 1 отключает повторы. Для тестов можно передать реализацию
SleeperInterface, чтобы не выполнять реальные задержки.
По умолчанию повтор разрешён для любого запроса. Точечные исключения задаются через
CallbackRetryableRequestPolicy:
Для сложных правил можно реализовать RetryableRequestPolicyInterface.
Генерация DTO
Генератор — инструмент сопровождения пакета: ему нужны phpsoftbox/cli-app, phpsoftbox/code-generator
(в suggest, в require не входят). Клиенту API эти зависимости не нужны.
DTO генерируются из локального docs/swagger.json:
Для одной версии:
Команда обновляет src/Dto/V* и src/Dto/OzonResponseDtoMap.php. Wrapper-классы по умолчанию не меняются: основной контракт остается OzonApiResponse/Collection, а DTO создаются явно через ->makeDto().
All versions of ozon with dependencies
phpsoftbox/collection Version ^1.0
psr/http-client Version ^1.0
psr/http-factory Version ^1.0
psr/http-message Version ^2.0