Перейти к содержанию

jobs

Источник API: АвитоРабота.json.

Enum

Пакет jobs.

Application dataclass

Application(
    transport: Transport, user_id: int | str | None = None
)

Bases: DomainObject

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

apply

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

Выполняет публичную операцию Application.apply и возвращает типизированную SDK-модель.

Параметр idempotency_key задает ключ идемпотентности для безопасного повтора write-операции.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

list

list(
    *,
    ids: Sequence[str] | None = None,
    query: ApplicationIdsQuery | None = None,
) -> ApplicationsResult | ApplicationIdsResult

Выполняет публичную операцию Application.list и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

get_states

get_states() -> ApplicationStatesResult

Выполняет публичную операцию Application.get_states и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

update

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

Выполняет публичную операцию Application.update и возвращает типизированную SDK-модель.

Параметр idempotency_key задает ключ идемпотентности для безопасного повтора write-операции.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

JobDictionary dataclass

JobDictionary(
    transport: Transport,
    dictionary_id: int | str | None = None,
    user_id: int | str | None = None,
)

Bases: DomainObject

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

list

list() -> JobDictionariesResult

Выполняет публичную операцию JobDictionary.list и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

get

get(
    *, dictionary_id: str | None = None
) -> JobDictionaryValuesResult

Выполняет публичную операцию JobDictionary.get и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

JobWebhook dataclass

JobWebhook(
    transport: Transport, user_id: int | str | None = None
)

Bases: DomainObject

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

get

get() -> JobWebhookInfo

Выполняет публичную операцию JobWebhook.get и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

list

list() -> JobWebhooksResult

Выполняет публичную операцию JobWebhook.list и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

update

update(
    *, url: str, idempotency_key: str | None = None
) -> JobWebhookInfo

Выполняет публичную операцию JobWebhook.update и возвращает типизированную SDK-модель.

Параметр idempotency_key задает ключ идемпотентности для безопасного повтора write-операции.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

delete

delete(
    *,
    url: str | None = None,
    idempotency_key: str | None = None,
) -> JobActionResult

Выполняет публичную операцию JobWebhook.delete и возвращает типизированную SDK-модель.

Параметр idempotency_key задает ключ идемпотентности для безопасного повтора write-операции.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

Resume dataclass

Resume(
    transport: Transport,
    resume_id: int | str | None = None,
    user_id: int | str | None = None,
)

Bases: DomainObject

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

list

list(
    *, query: ResumeSearchQuery | None = None
) -> ResumesResult

Выполняет публичную операцию Resume.list и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

get

get(*, resume_id: int | str | None = None) -> ResumeInfo

Выполняет публичную операцию Resume.get и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

get_contacts

get_contacts(
    *, resume_id: int | str | None = None
) -> ResumeContactInfo

Выполняет публичную операцию Resume.get_contacts и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

Vacancy dataclass

Vacancy(
    transport: Transport,
    vacancy_id: int | str | None = None,
    user_id: int | str | None = None,
)

Bases: DomainObject

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

create

create(
    *,
    title: str,
    version: int = 2,
    idempotency_key: str | None = None,
) -> JobActionResult

Выполняет публичную операцию Vacancy.create и возвращает типизированную SDK-модель.

Параметр idempotency_key задает ключ идемпотентности для безопасного повтора write-операции.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

update

update(
    *,
    title: str,
    vacancy_id: int | str | None = None,
    vacancy_uuid: str | None = None,
    version: int = 2,
    idempotency_key: str | None = None,
) -> JobActionResult

Выполняет публичную операцию Vacancy.update и возвращает типизированную SDK-модель.

Параметр idempotency_key задает ключ идемпотентности для безопасного повтора write-операции.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

delete

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

Выполняет публичную операцию Vacancy.delete и возвращает типизированную SDK-модель.

Параметр idempotency_key задает ключ идемпотентности для безопасного повтора write-операции.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

prolongate

prolongate(
    *,
    billing_type: str,
    vacancy_id: int | str | None = None,
    idempotency_key: str | None = None,
) -> JobActionResult

Выполняет публичную операцию Vacancy.prolongate и возвращает типизированную SDK-модель.

Параметр idempotency_key задает ключ идемпотентности для безопасного повтора write-операции.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

list

list(
    *, query: VacanciesQuery | None = None
) -> VacanciesResult

Выполняет публичную операцию Vacancy.list и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

get

get(
    *,
    vacancy_id: int | str | None = None,
    query: VacanciesQuery | None = None,
) -> VacancyInfo

Выполняет публичную операцию Vacancy.get и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

get_by_ids

get_by_ids(*, ids: Sequence[int]) -> VacanciesResult

Выполняет публичную операцию Vacancy.get_by_ids и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

get_statuses

get_statuses(
    *, ids: Sequence[int]
) -> VacancyStatusesResult

Выполняет публичную операцию Vacancy.get_statuses и возвращает типизированную SDK-модель.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

Raises: AvitoError с полями 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,
) -> JobActionResult

Выполняет публичную операцию Vacancy.update_auto_renewal и возвращает типизированную SDK-модель.

Параметр idempotency_key задает ключ идемпотентности для безопасного повтора write-операции.

Пустой результат возвращается как пустая коллекция или None согласно аннотации метода.

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

ApplicationStatus

Bases: str, Enum

Статус отклика.

JobActionStatus

Bases: str, Enum

Статус мутационной операции jobs.

VacancyStatus

Bases: str, Enum

Статус вакансии.

ApplicationActionRequest dataclass

ApplicationActionRequest(ids: list[str], action: str)

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

to_payload

to_payload() -> dict[str, object]

Сериализует действие над откликами.

ApplicationIdsQuery dataclass

ApplicationIdsQuery(updated_at_from: str)

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

to_params

to_params() -> dict[str, str]

Сериализует query-параметры идентификаторов откликов.

ApplicationIdsRequest dataclass

ApplicationIdsRequest(ids: list[str])

Запрос получения откликов по идентификаторам.

to_payload

to_payload() -> dict[str, object]

Сериализует идентификаторы откликов.

ApplicationIdsResult dataclass

ApplicationIdsResult(
    items: list[ApplicationIdItem],
    cursor: str | None = None,
)

Bases: SerializableModel

Постраничный список идентификаторов откликов.

ApplicationsResult dataclass

ApplicationsResult(items: list[ApplicationInfo])

Bases: SerializableModel

Список откликов.

ApplicationStatesResult dataclass

ApplicationStatesResult(items: list[ApplicationState])

Bases: SerializableModel

Список возможных статусов откликов.

ApplicationViewedItem dataclass

ApplicationViewedItem(id: str, is_viewed: bool)

Флаг просмотра для отклика.

to_payload

to_payload() -> dict[str, object]

Сериализует флаг просмотра отклика.

ApplicationViewedRequest dataclass

ApplicationViewedRequest(
    applies: list[ApplicationViewedItem],
)

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

to_payload

to_payload() -> dict[str, object]

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

JobActionResult dataclass

JobActionResult(
    success: bool,
    id: str | None = None,
    status: JobActionStatus | None = None,
    message: str | None = None,
)

Bases: SerializableModel

Результат mutation-операции Jobs API.

JobDictionariesResult dataclass

JobDictionariesResult(items: list[JobDictionaryInfo])

Bases: SerializableModel

Список доступных словарей.

JobDictionaryValuesResult dataclass

JobDictionaryValuesResult(items: list[JobDictionaryValue])

Bases: SerializableModel

Список значений словаря.

JobWebhookInfo dataclass

JobWebhookInfo(
    url: str | None,
    is_active: bool | None,
    version: str | None,
)

Bases: SerializableModel

Подписка webhook раздела Работа.

JobWebhooksResult dataclass

JobWebhooksResult(items: list[JobWebhookInfo])

Bases: SerializableModel

Список webhook-подписок.

JobWebhookUpdateRequest dataclass

JobWebhookUpdateRequest(url: str)

Запрос обновления webhook откликов.

to_payload

to_payload() -> dict[str, object]

Сериализует webhook откликов.

ResumeContactInfo dataclass

ResumeContactInfo(
    name: str | None, phone: str | None, email: str | None
)

Bases: SerializableModel

Контакты соискателя.

ResumeInfo dataclass

ResumeInfo(
    id: str | None,
    title: str | None,
    candidate_name: str | None,
    location: str | None,
    salary: int | None,
)

Bases: SerializableModel

Краткая или полная информация о резюме.

ResumeSearchQuery dataclass

ResumeSearchQuery(query: str)

Query поиска резюме.

to_params

to_params() -> dict[str, str]

Сериализует query поиска резюме.

ResumesResult dataclass

ResumesResult(
    items: list[ResumeInfo],
    cursor: str | None = None,
    total: int | None = None,
)

Bases: SerializableModel

Результат поиска резюме.

VacanciesQuery dataclass

VacanciesQuery(query: str | None = None)

Query списка или карточки вакансий.

to_params

to_params() -> dict[str, str]

Сериализует query вакансий.

VacanciesResult dataclass

VacanciesResult(
    items: list[VacancyInfo], total: int | None = None
)

Bases: SerializableModel

Список вакансий.

VacancyArchiveRequest dataclass

VacancyArchiveRequest(employee_id: int)

Запрос архивации вакансии v1.

to_payload

to_payload() -> dict[str, object]

Сериализует архивацию вакансии.

VacancyAutoRenewalRequest dataclass

VacancyAutoRenewalRequest(auto_renewal: bool)

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

to_payload

to_payload() -> dict[str, object]

Сериализует флаг автообновления.

VacancyCreateRequest dataclass

VacancyCreateRequest(title: str)

Запрос создания вакансии.

to_payload

to_payload() -> dict[str, object]

Сериализует создание вакансии.

VacancyIdsRequest dataclass

VacancyIdsRequest(ids: list[int])

Запрос списка вакансий по идентификаторам.

to_payload

to_payload() -> dict[str, object]

Сериализует идентификаторы вакансий.

VacancyInfo dataclass

VacancyInfo(
    id: str | None,
    uuid: str | None,
    title: str | None,
    status: VacancyStatus | None,
    url: str | None,
)

Bases: SerializableModel

Информация о вакансии.

VacancyProlongateRequest dataclass

VacancyProlongateRequest(billing_type: str)

Запрос продления вакансии v1.

to_payload

to_payload() -> dict[str, object]

Сериализует продление вакансии.

VacancyStatusesResult dataclass

VacancyStatusesResult(items: list[VacancyStatusInfo])

Bases: SerializableModel

Список статусов вакансий.

VacancyUpdateRequest dataclass

VacancyUpdateRequest(title: str)

Запрос обновления вакансии.

to_payload

to_payload() -> dict[str, object]

Сериализует обновление вакансии.