AvitoClient¶

AvitoClient — единственная публичная точка входа SDK. Он владеет конфигурацией, auth-provider и transport-слоем, а наружу отдаёт только доменные объекты.

Контракт¶

AvitoClient.from_env() — основной путь для конфигурации из окружения.
AvitoClient(client_id=..., client_secret=...) — короткий явный путь для OAuth credentials.
AvitoClient(AvitoSettings(...)) — полный путь для расширенной конфигурации.
Клиент поддерживает context manager и закрывает внутренние HTTP-клиенты в close().
После close() публичные операции поднимают ConfigurationError.
debug_info() возвращает безопасный диагностический снимок без OAuth-секретов.

Фасад¶

Единственная публичная точка входа SDK с фабриками доменных объектов.

Пример

from avito import AvitoClient

with AvitoClient() as avito:
    profile = avito.account().get_self()
    ad = avito.ad(42).get()

from_env `classmethod` ¶

from_env(
    *, env_file: str | Path | None = ".env"
) -> AvitoClient

Создает клиент из переменных окружения и optional .env файла.

auth ¶

auth() -> AuthProvider

Возвращает объект аутентификации и token-flow операций.

Raises: AvitoError с полями operation, status, request_id, attempt, method и endpoint.

debug_info ¶

debug_info() -> TransportDebugInfo

Возвращает безопасный снимок transport-настроек для диагностики.

close ¶

close() -> None

Закрывает внутренние HTTP-клиенты SDK.

account ¶

account(user_id: int | str | None = None) -> Account

Создает доменный объект аккаунта.

account_hierarchy ¶

account_hierarchy(
    user_id: int | str | None = None,
) -> AccountHierarchy

Создает доменный объект иерархии аккаунта.

ad ¶

ad(
    item_id: int | str | None = None,
    user_id: int | str | None = None,
) -> Ad

Создает доменный объект объявления.

ad_stats ¶

ad_stats(
    item_id: int | str | None = None,
    user_id: int | str | None = None,
) -> AdStats

Создает доменный объект статистики объявления.

ad_promotion ¶

ad_promotion(
    item_id: int | str | None = None,
    user_id: int | str | None = None,
) -> AdPromotion

Создает доменный объект продвижения объявления.

autoload_profile ¶

autoload_profile(
    user_id: int | str | None = None,
) -> AutoloadProfile

Создает доменный объект профиля автозагрузки.

autoload_report ¶

autoload_report(
    report_id: int | str | None = None,
) -> AutoloadReport

Создает доменный объект отчета автозагрузки.

autoload_archive ¶

autoload_archive(
    report_id: int | str | None = None,
) -> AutoloadArchive

Создает доменный объект архивных операций автозагрузки.

chat ¶

chat(
    chat_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> Chat

Создает доменный объект чата.

chat_message ¶

chat_message(
    message_id: int | str | None = None,
    *,
    chat_id: int | str | None = None,
    user_id: int | str | None = None,
) -> ChatMessage

Создает доменный объект сообщения чата.

chat_webhook ¶

chat_webhook() -> ChatWebhook

Создает доменный объект webhook мессенджера.

chat_media ¶

chat_media(
    *, user_id: int | str | None = None
) -> ChatMedia

Создает доменный объект медиа мессенджера.

special_offer_campaign ¶

special_offer_campaign(
    campaign_id: int | str | None = None,
) -> SpecialOfferCampaign

Создает доменный объект рассылки спецпредложений.

promotion_order ¶

promotion_order(
    order_id: int | str | None = None,
) -> PromotionOrder

Создает доменный объект заявки на продвижение.

bbip_promotion ¶

bbip_promotion(
    item_id: int | str | None = None,
) -> BbipPromotion

Создает доменный объект BBIP-продвижения.

trx_promotion ¶

trx_promotion(
    item_id: int | str | None = None,
) -> TrxPromotion

Создает доменный объект TrxPromo.

cpa_auction ¶

cpa_auction(item_id: int | str | None = None) -> CpaAuction

Создает доменный объект CPA-аукциона.

target_action_pricing ¶

target_action_pricing(
    item_id: int | str | None = None,
) -> TargetActionPricing

Создает доменный объект цены целевого действия.

autostrategy_campaign ¶

autostrategy_campaign(
    campaign_id: int | str | None = None,
) -> AutostrategyCampaign

Создает доменный объект автостратегии.

order ¶

order() -> Order

Создает доменный объект заказа.

order_label ¶

order_label(task_id: int | str | None = None) -> OrderLabel

Создает доменный объект этикетки заказа.

delivery_order ¶

delivery_order() -> DeliveryOrder

Создает доменный объект доставки.

sandbox_delivery ¶

sandbox_delivery() -> SandboxDelivery

Создает доменный объект песочницы доставки.

delivery_task ¶

delivery_task(
    task_id: int | str | None = None,
) -> DeliveryTask

Создает доменный объект задачи доставки.

stock ¶

stock() -> Stock

Создает доменный объект остатков.

vacancy ¶

vacancy(vacancy_id: int | str | None = None) -> Vacancy

Создает доменный объект вакансии.

application ¶

application() -> Application

Создает доменный объект отклика.

resume ¶

resume(resume_id: int | str | None = None) -> Resume

Создает доменный объект резюме.

job_webhook ¶

job_webhook() -> JobWebhook

Создает доменный объект webhook раздела Работа.

job_dictionary ¶

job_dictionary(
    dictionary_id: int | str | None = None,
) -> JobDictionary

Создает доменный объект словаря Работа.

cpa_lead ¶

cpa_lead() -> CpaLead

Создает доменный объект CPA-лида.

cpa_chat ¶

cpa_chat(chat_id: int | str | None = None) -> CpaChat

Создает доменный объект CPA-чата.

cpa_call ¶

cpa_call() -> CpaCall

Создает доменный объект CPA-звонка.

cpa_archive ¶

cpa_archive(call_id: int | str | None = None) -> CpaArchive

Создает доменный объект архивных операций CPA.

call_tracking_call ¶

call_tracking_call(
    call_id: int | str | None = None,
) -> CallTrackingCall

Создает доменный объект CallTracking.

autoteka_vehicle ¶

autoteka_vehicle(
    vehicle_id: int | str | None = None,
) -> AutotekaVehicle

Создает доменный объект транспортного средства Автотеки.

autoteka_report ¶

autoteka_report(
    report_id: int | str | None = None,
) -> AutotekaReport

Создает доменный объект отчета Автотеки.

autoteka_monitoring ¶

autoteka_monitoring() -> AutotekaMonitoring

Создает доменный объект мониторинга Автотеки.

autoteka_scoring ¶

autoteka_scoring(
    scoring_id: int | str | None = None,
) -> AutotekaScoring

Создает доменный объект скоринга Автотеки.

autoteka_valuation ¶

autoteka_valuation() -> AutotekaValuation

Создает доменный объект оценки Автотеки.

realty_listing ¶

realty_listing(
    item_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> RealtyListing

Создает доменный объект объявления недвижимости.

realty_booking ¶

realty_booking(
    item_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> RealtyBooking

Создает доменный объект бронирования недвижимости.

realty_pricing ¶

realty_pricing(
    item_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> RealtyPricing

Создает доменный объект цен недвижимости.

realty_analytics_report ¶

realty_analytics_report(
    item_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> RealtyAnalyticsReport

Создает доменный объект аналитического отчета недвижимости.

review ¶

review() -> Review

Создает доменный объект отзыва.

review_answer ¶

review_answer(
    answer_id: int | str | None = None,
) -> ReviewAnswer

Создает доменный объект ответа на отзыв.

rating_profile ¶

rating_profile() -> RatingProfile

Создает доменный объект рейтингового профиля.

tariff ¶

tariff(tariff_id: int | str | None = None) -> Tariff

Создает доменный объект тарифа.

Безопасная диагностика¶