Download the PHP package phpsoftbox/yandex-market without Composer
On this page you can find all versions of the php package phpsoftbox/yandex-market. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download phpsoftbox/yandex-market
More information about phpsoftbox/yandex-market
Files in phpsoftbox/yandex-market
Package yandex-market
Short Description Yandex Market Partner API client component for the PhpSoftBox framework
License MIT
Informations about the package yandex-market
PhpSoftBox YandexMarket
About
phpsoftbox/yandex-market — API-клиент Yandex Market Partner API на базе PSR-18.
Компонент включает:
YandexMarketApiClientс auth черезApi-KeyилиAuthorization: Bearer;- универсальные HTTP-методы
get/post/put/patch/delete/request; - helper версии API:
v1()иv2(); - ответы в
YandexMarketApiResponse, совместимом сPhpSoftBox\Collection\Collection; YandexMarketApiResponse::makeDto()для явного преобразования ответа в DTO после генерации карты;YandexMarketExceptionсо статусом и payload.
Источник спецификации
- документация:
https://yandex.ru/dev/market/partner-api/doc/ru/concepts/openapi - OpenAPI git:
https://github.com/yandex-market/yandex-market-partner-api(openapi/openapi.yaml)
Quick Start
Повтор запросов при превышении лимита
Клиент автоматически повторяет запросы после rate-limit ответов Yandex Market:
420 Enhance Your Calm, используемого актуальным Partner API;429 Too Many Requestsдля совместимости с другими контурами API.
Повтор разрешён для всех HTTP-методов и выполняется только после фактически полученного rate-limit ответа. Сетевые ошибки, timeout и остальные HTTP-статусы сохраняют прежнее поведение.
По умолчанию выполняется не более четырёх попыток, включая первоначальный запрос. Без корректного заголовка применяются задержки 1, 2 и 4 секунды. Клиент понимает:
Retry-After— секунды либо HTTP-date;X-RateLimit-Retry— секунды;X-RateLimit-Resource-Until— абсолютную дату RFC822, после которой ресурс снова станет доступен.
Если сервер передал несколько ограничений, выбирается наибольшая задержка. Для
X-RateLimit-Resource-Until она может быть длительной, поэтому по умолчанию действуют
два бюджета:
- одна задержка — не более 30 секунд (
maxDelaySeconds); - сумма задержек одного вызова клиента — не более 60 секунд (
maxTotalDelaySeconds).
Задержка не обрезается до лимита: более ранний повтор противоречил бы заголовку. Вместо
ожидания клиент выбрасывает YandexMarketException со статусом последнего ответа (420/429)
и его payload. null в параметре отключает соответствующее ограничение.
Тело каждого повтора создаётся заново из сохранённого JSON, поэтому запрос полностью воспроизводится даже после чтения предыдущего body stream.
Настройка retry
Для тестов можно передать SleeperInterface. Точечные исключения настраиваются через
CallbackRetryableRequestPolicy, а сложные правила — собственной реализацией
RetryableRequestPolicyInterface:
DTO ответы
Wrapper-методы остаются совместимыми с Collection. Если для endpoint-а есть сгенерированный DTO, response можно явно преобразовать:
Генерация DTO
Генератор — инструмент сопровождения пакета: ему нужны phpsoftbox/cli-app, phpsoftbox/code-generator, symfony/yaml
(в suggest, в require не входят). Клиенту API эти зависимости не нужны.
Генератор ожидает локальный OpenAPI YAML/JSON файл. По умолчанию используется docs/openapi.yaml:
Можно указать путь явно:
Команда обновляет src/Dto и src/Dto/YandexMarketResponseDtoMap.php. Wrapper-классы не меняются: основной контракт остается YandexMarketApiResponse/Collection, а DTO создаются явно через makeDto().
All versions of yandex-market 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