Explanations¶
Explanations описывают причины архитектурных решений SDK: границы слоёв, retry-поведение, модель ошибок, безопасность диагностики и правила обратной совместимости.
| Статья | Что объясняет |
|---|---|
| Архитектура SDK | Как AvitoClient, домены, section clients, transport, auth и mappers разделяют ответственность |
| OAuth и токены | Почему token-flow скрыт за AuthProvider |
| Transport и retry | Почему retry живёт в transport-слое и как учитываются 429/5xx |
| Модель ошибок | Как HTTP-коды превращаются в typed exceptions |
| Семантика пагинации | Почему PaginatedList ленивый и когда загружаются страницы |
| Dry-run и идемпотентность | Как write-операции проверяются без сетевого вызова |
| Стратегия тестирования | Как FakeTransport, contract-тесты и docs-harness проверяют SDK |
| Покрытие API и deprecation | Как spec, inventory, reference и runtime warnings связаны между собой |
| Resolution конфигурации | Как env, .env и defaults превращаются в AvitoSettings |
| Security и redaction | Какие секреты SDK не раскрывает в диагностике и ошибках |
Для практических сценариев используйте how-to рецепты, а для полного API-контракта — reference.