jobs

Публичный доменный пакет SDK: jobs.

Enum

• ApplicationStatus
• JobActionStatus
• JobEnrichmentStatus
• JobMatchingStatus
• VacancyBillingType
• VacancyEmployment
• VacancyExperience
• VacancyModerationStatus
• VacancySchedule
• VacancyStatus

Bases: DomainObject

Доменный объект откликов.

apply

apply(
    *,
    ids: Sequence[str],
    action: str,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Применяет действие к откликов на вакансии.

Аргументы

ids: передает идентификаторы объектов для пакетной операции. action: задает действие над откликами. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_by_ids

get_by_ids(
    *,
    ids: Sequence[str],
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> ApplicationsResult

Возвращает отклики по идентификаторам и возвращает типизированную SDK-модель.

Аргументы

ids: передает идентификаторы откликов. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

ApplicationsResult со списком найденных откликов.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_ids

get_ids(
    *,
    updated_at_from: DateInput,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> ApplicationIdsResult

Возвращает идентификаторы откликов по фильтру и возвращает типизированную SDK-модель.

Аргументы

updated_at_from: фильтрует отклики по нижней границе даты обновления. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

ApplicationIdsResult со списком идентификаторов откликов.

Поведение

updated_at_from сериализуется в ISO datetime перед выполнением запроса. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_states

get_states(
    *,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> ApplicationStatesResult

Возвращает states для откликов на вакансии.

Аргументы

timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

ApplicationStatesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

update

update(
    *,
    applies: Sequence[ApplicationViewedItem],
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Обновляет отметки просмотра откликов на вакансии.

Аргументы

applies: передает список отметок просмотра откликов. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: DomainObject

Доменный объект словарей вакансий.

list

list(
    *,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobDictionariesResult

Возвращает список справочников Авито Работы.

Аргументы

timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobDictionariesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get

get(
    *,
    dictionary_id: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobDictionaryValuesResult

Возвращает справочников Авито Работы.

Аргументы

dictionary_id: идентифицирует справочник. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobDictionaryValuesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: DomainObject

Доменный объект webhook откликов.

get

get(
    *,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobWebhookInfo

Возвращает webhook-уведомлений Авито Работы.

Аргументы

timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobWebhookInfo с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

list

list(
    *,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobWebhooksResult

Возвращает список webhook-уведомлений Авито Работы.

Аргументы

timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobWebhooksResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

update

update(
    *,
    url: str,
    secret: str,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobWebhookInfo

Обновляет webhook-уведомление Авито Работы.

Аргументы

url: задает URL webhook-подписки. secret: задает секрет webhook-подписки. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobWebhookInfo с типизированными данными ответа API.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

delete

delete(
    *,
    url: str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Удаляет webhook-уведомление Авито Работы.

Аргументы

url: задает URL webhook-подписки. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: DomainObject

Доменный объект резюме.

list

list(
    *,
    query: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> ResumesResult

Возвращает список резюме.

Аргументы

query: передает поисковую строку или фильтр upstream API. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

ResumesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get

get(
    *,
    resume_id: int | str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> ResumeInfo

Возвращает резюме.

Аргументы

resume_id: идентифицирует резюме. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

ResumeInfo с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_contacts

get_contacts(
    *,
    resume_id: int | str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> ResumeContactInfo

Возвращает contacts для резюме.

Аргументы

resume_id: идентифицирует резюме. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

ResumeContactInfo с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: DomainObject

Доменный объект вакансий.

create

create(
    *,
    title: str,
    billing_type: VacancyBillingTypeInput,
    description: str | None = None,
    business_area: int | None = None,
    employment: VacancyEmploymentInput | None = None,
    schedule: VacancyScheduleInput | None = None,
    experience: VacancyExperienceInput | None = None,
    version: int = 2,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Создает вакансию.

Аргументы

title: передает название вакансии. billing_type: задает тип биллинга. description: передает описание вакансии для legacy v1 operation. business_area: задает сферу деятельности для legacy v1 operation. employment: задает тип занятости для legacy v1 operation. schedule: задает режим работы для legacy v1 operation. experience: задает требуемый опыт для legacy v1 operation. version: задает версию upstream-контракта, если операция ее поддерживает. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

create_classic

create_classic(
    *,
    title: str,
    description: str,
    billing_type: VacancyBillingTypeInput,
    business_area: int,
    employment: VacancyEmploymentInput,
    schedule: VacancyScheduleInput,
    experience: VacancyExperienceInput,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Создает вакансию через legacy v1 operation.

Аргументы

title: передает название вакансии в Swagger поле name. description: передает описание вакансии. billing_type: задает тип биллинга. business_area: задает сферу деятельности. employment: задает тип занятости. schedule: задает режим работы. experience: задает требуемый опыт. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

update

update(
    *,
    title: str,
    billing_type: VacancyBillingTypeInput,
    vacancy_id: int | str | None = None,
    vacancy_uuid: str | None = None,
    version: int = 2,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Обновляет вакансию.

Аргументы

title: передает название вакансии. billing_type: задает тип биллинга. vacancy_id: идентифицирует вакансию. vacancy_uuid: идентифицирует вакансию по UUID. version: задает версию upstream-контракта, если операция ее поддерживает. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

update_classic

update_classic(
    *,
    title: str,
    billing_type: VacancyBillingTypeInput,
    vacancy_id: int | str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Обновляет вакансию через legacy v1 operation.

Аргументы

title: передает название вакансии в Swagger поле name. billing_type: задает тип биллинга. vacancy_id: идентифицирует вакансию. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

delete

delete(
    *,
    employee_id: int,
    vacancy_id: int | str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Удаляет вакансию.

Аргументы

employee_id: идентифицирует сотрудника аккаунта. vacancy_id: идентифицирует вакансию. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

prolongate

prolongate(
    *,
    billing_type: VacancyBillingTypeInput,
    vacancy_id: int | str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Продлевает вакансий.

Аргументы

billing_type: задает тип биллинга для продления вакансии. vacancy_id: идентифицирует вакансию. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

list

list(
    *,
    query: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> VacanciesResult

Возвращает список вакансий.

Аргументы

query: передает поисковую строку или фильтр upstream API. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

VacanciesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get

get(
    *,
    vacancy_id: int | str | None = None,
    query: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> VacancyInfo

Возвращает вакансий.

Аргументы

vacancy_id: идентифицирует вакансию. query: передает поисковую строку или фильтр upstream API. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

VacancyInfo с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_by_ids

get_by_ids(
    *,
    ids: Sequence[int],
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> VacanciesResult

Возвращает вакансий.

Аргументы

ids: передает идентификаторы объектов для пакетной операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

VacanciesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_statuses

get_statuses(
    *,
    ids: Sequence[str],
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> VacancyStatusesResult

Возвращает statuses для вакансий.

Аргументы

ids: передает идентификаторы объектов для пакетной операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

VacancyStatusesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

update_auto_renewal

update_auto_renewal(
    *,
    auto_renewal: bool,
    vacancy_uuid: str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Обновляет настройку автопродления вакансии.

Аргументы

auto_renewal: включает или отключает автопродление вакансии. vacancy_uuid: идентифицирует вакансию по UUID. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: AsyncDomainObject

Доменный объект откликов.

apply async

apply(
    *,
    ids: Sequence[str],
    action: str,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Применяет действие к откликов на вакансии.

Аргументы

ids: передает идентификаторы объектов для пакетной операции. action: задает действие над откликами. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_by_ids async

get_by_ids(
    *,
    ids: Sequence[str],
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> ApplicationsResult

Возвращает отклики по идентификаторам и возвращает типизированную SDK-модель.

Аргументы

ids: передает идентификаторы откликов. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

ApplicationsResult со списком найденных откликов.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_ids async

get_ids(
    *,
    updated_at_from: DateInput,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> ApplicationIdsResult

Возвращает идентификаторы откликов по фильтру и возвращает типизированную SDK-модель.

Аргументы

updated_at_from: фильтрует отклики по нижней границе даты обновления. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

ApplicationIdsResult со списком идентификаторов откликов.

Поведение

updated_at_from сериализуется в ISO datetime перед выполнением запроса. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_states async

get_states(
    *,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> ApplicationStatesResult

Возвращает states для откликов на вакансии.

Аргументы

timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

ApplicationStatesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

update async

update(
    *,
    applies: Sequence[ApplicationViewedItem],
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Обновляет отметки просмотра откликов на вакансии.

Аргументы

applies: передает список отметок просмотра откликов. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: AsyncDomainObject

Доменный объект словарей вакансий.

list async

list(
    *,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobDictionariesResult

Возвращает список справочников Авито Работы.

Аргументы

timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobDictionariesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get async

get(
    *,
    dictionary_id: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobDictionaryValuesResult

Возвращает справочников Авито Работы.

Аргументы

dictionary_id: идентифицирует справочник. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobDictionaryValuesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: AsyncDomainObject

Доменный объект webhook откликов.

get async

get(
    *,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobWebhookInfo

Возвращает webhook-уведомлений Авито Работы.

Аргументы

timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobWebhookInfo с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

list async

list(
    *,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobWebhooksResult

Возвращает список webhook-уведомлений Авито Работы.

Аргументы

timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobWebhooksResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

update async

update(
    *,
    url: str,
    secret: str,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobWebhookInfo

Обновляет webhook-уведомление Авито Работы.

Аргументы

url: задает URL webhook-подписки. secret: задает секрет webhook-подписки. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobWebhookInfo с типизированными данными ответа API.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

delete async

delete(
    *,
    url: str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Удаляет webhook-уведомление Авито Работы.

Аргументы

url: задает URL webhook-подписки. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: AsyncDomainObject

Доменный объект резюме.

list async

list(
    *,
    query: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> ResumesResult

Возвращает список резюме.

Аргументы

query: передает поисковую строку или фильтр upstream API. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

ResumesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get async

get(
    *,
    resume_id: int | str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> ResumeInfo

Возвращает резюме.

Аргументы

resume_id: идентифицирует резюме. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

ResumeInfo с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_contacts async

get_contacts(
    *,
    resume_id: int | str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> ResumeContactInfo

Возвращает contacts для резюме.

Аргументы

resume_id: идентифицирует резюме. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

ResumeContactInfo с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

Bases: AsyncDomainObject

Доменный объект вакансий.

create async

create(
    *,
    title: str,
    billing_type: VacancyBillingTypeInput,
    description: str | None = None,
    business_area: int | None = None,
    employment: VacancyEmploymentInput | None = None,
    schedule: VacancyScheduleInput | None = None,
    experience: VacancyExperienceInput | None = None,
    version: int = 2,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Создает вакансию.

Аргументы

title: передает название вакансии. billing_type: задает тип биллинга. description: передает описание вакансии для legacy v1 operation. business_area: задает сферу деятельности для legacy v1 operation. employment: задает тип занятости для legacy v1 operation. schedule: задает режим работы для legacy v1 operation. experience: задает требуемый опыт для legacy v1 operation. version: задает версию upstream-контракта, если операция ее поддерживает. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

create_classic async

create_classic(
    *,
    title: str,
    description: str,
    billing_type: VacancyBillingTypeInput,
    business_area: int,
    employment: VacancyEmploymentInput,
    schedule: VacancyScheduleInput,
    experience: VacancyExperienceInput,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Создает вакансию через legacy v1 operation.

Аргументы

title: передает название вакансии в Swagger поле name. description: передает описание вакансии. billing_type: задает тип биллинга. business_area: задает сферу деятельности. employment: задает тип занятости. schedule: задает режим работы. experience: задает требуемый опыт. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

update async

update(
    *,
    title: str,
    billing_type: VacancyBillingTypeInput,
    vacancy_id: int | str | None = None,
    vacancy_uuid: str | None = None,
    version: int = 2,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Обновляет вакансию.

Аргументы

title: передает название вакансии. billing_type: задает тип биллинга. vacancy_id: идентифицирует вакансию. vacancy_uuid: идентифицирует вакансию по UUID. version: задает версию upstream-контракта, если операция ее поддерживает. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

update_classic async

update_classic(
    *,
    title: str,
    billing_type: VacancyBillingTypeInput,
    vacancy_id: int | str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Обновляет вакансию через legacy v1 operation.

Аргументы

title: передает название вакансии в Swagger поле name. billing_type: задает тип биллинга. vacancy_id: идентифицирует вакансию. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

delete async

delete(
    *,
    employee_id: int,
    vacancy_id: int | str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Удаляет вакансию.

Аргументы

employee_id: идентифицирует сотрудника аккаунта. vacancy_id: идентифицирует вакансию. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

prolongate async

prolongate(
    *,
    billing_type: VacancyBillingTypeInput,
    vacancy_id: int | str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Продлевает вакансий.

Аргументы

billing_type: задает тип биллинга для продления вакансии. vacancy_id: идентифицирует вакансию. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

list async

list(
    *,
    query: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> VacanciesResult

Возвращает список вакансий.

Аргументы

query: передает поисковую строку или фильтр upstream API. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

VacanciesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get async

get(
    *,
    vacancy_id: int | str | None = None,
    query: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> VacancyInfo

Возвращает вакансий.

Аргументы

vacancy_id: идентифицирует вакансию. query: передает поисковую строку или фильтр upstream API. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

VacancyInfo с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_by_ids async

get_by_ids(
    *,
    ids: Sequence[int],
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> VacanciesResult

Возвращает вакансий.

Аргументы

ids: передает идентификаторы объектов для пакетной операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

VacanciesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

get_statuses async

get_statuses(
    *,
    ids: Sequence[str],
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> VacancyStatusesResult

Возвращает statuses для вакансий.

Аргументы

ids: передает идентификаторы объектов для пакетной операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

VacancyStatusesResult с типизированными данными ответа API.

Поведение

timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.

update_auto_renewal async

update_auto_renewal(
    *,
    auto_renewal: bool,
    vacancy_uuid: str | None = None,
    idempotency_key: str | None = None,
    timeout: ApiTimeouts | None = None,
    retry: RetryOverride | None = None,
) -> JobActionResult

Обновляет настройку автопродления вакансии.

Аргументы

auto_renewal: включает или отключает автопродление вакансии. vacancy_uuid: идентифицирует вакансию по UUID. idempotency_key: задает ключ идемпотентности для безопасного повтора write-операции. timeout: переопределяет таймауты HTTP-запроса для этого вызова. retry: переопределяет retry-политику операции: default, enabled или disabled.

Возвращает

JobActionResult со статусом выполнения операции.

Поведение

idempotency_key следует передавать для write-операций, которые могут безопасно повторяться. timeout и retry действуют только на этот вызов и не меняют настройки клиента.

Исключения

AvitoError: ошибка SDK с контекстом operation, status, request_id, attempt, method и endpoint.