Skip to content

Latest commit

 

History

History
212 lines (173 loc) · 8.08 KB

agency_vacancies.md

File metadata and controls

212 lines (173 loc) · 8.08 KB
Raw

Работа с вакансиями Кадрового Агенства

Добавление вакансии

Если организация --- не Кадровое Агенство, то используется другой набор полей.

POST /account/{account_id}/vacancies

В теле запроса необходимо передать JSON вида:

{
    "client_vacancy_request": 11,
    "deadline": "2030-09-03",
    "applicants_to_hire": 2,
    "priority": 1,
    "body": "<p>Some text</p>",
    "requirements": "<p>Another text</p>",
    "conditions": "<p>Different text</p>",
    "files": [1, 2, 3]
}

Поля запроса

Имя Тип Обязательный Описание
client_vacancy_request number Да Идентификатор заявки на вакансию для Кадрового Агенства
deadline date Нет Дата дедлайна по вакансии
priority number Нет Приоритет вакансии (может быть или 0 (обычный), или 1 (высокий))
body string Нет Обязанности в формате HTML. Доступные теги: ul, ol, li, p, br, a, strong, em, u, b, i
requirements string Нет Требования в формате HTML. Доступные теги: ul, ol, li, p, br, a, strong, em, u, b, i
conditions string Нет Условия работы в формате HTML. Доступные теги: ul, ol, li, p, br, a, strong, em, u,b, i
files array Нет Список файлов, прикрепленных к вакансии (загрузка файлов)

Поля ответа

Дополнительно к полям запроса также будут добавлены поля:

{
    "id": 1,
    "created": "2017-04-10T21:34:01+03:00",
    "position": "Моя должность"
}
Имя Тип Описание
id number Идентификатор вакансии
created datetime Дата и время создания вакансии
position string Название вакансии (должности). Определяется по полю position из заявки на вакансию для Кадрового Агенства

Редактирование вакансии

Если организация --- не Кадровое Агенство, то используется другой набор полей.

PUT /account/{account_id}/vacancies/{vacancy_id}

Поля запроса

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

Поля ответа

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

Удаление вакансии

DELETE /account/{account_id}/vacancies/{vacancy_id}

Поля запроса

Тело запроса должно быть пустым

Поля ответа

{
    "status": true
}
Имя Тип Описание
status bool Флаг успешной операции

Получение списка вакансий

Если организация --- не Кадровое Агенство, то возвращается другой набор полей.

GET /account/{account_id}/vacancies вернёт список вакансий компании.

Принимаемые параметры:

  • mine — логическое поле. Если передается, то вернутся только вакансии, над которыми работает текущий пользователь.

  • opened — логическое поле. Если передается, то вернутся только открытые вакансии

  • count, page — параметры постраничного вывода.

{
    "items": [
        {
            "id": 4531,
            "position": "Менеджер по продажам",
            "deadline": "2017-04-27",
            "applicants_to_hire": 1,
            "created": "2017-03-22T18:16:27+03:00",
            "priority": 0,
            "state": "OPEN",
            "company": "Название компании"
        },
        {
            "id": 4530,
            "position": "Программист Python",
            "deadline": null,
            "applicants_to_hire": 1,
            "created": "2017-03-22T18:16:27+03:00",
            "priority": 0,
            "state": "CLOSED",
            "company": "Название компании"
        }
    ],
    "total": 2,
    "page": 1,
    "count": 30
}

Имя Тип Описание
id number Идентификатор вакансии
position string Название вакансии (должности)
deadline date Дата дедлайна по вакансии
applicants_to_hire number Количество кандидатов к найму
created datetime Дата и время создания вакансии
priority number Приоритет вакансии (может быть или 0 (обычный), или 1 (высокий))
state string Состояние вакансии
company string Название компании

Получение вакансии

Если организация --- не Кадровое Агенство, то возвращается другой набор полей.

GET /account/{account_id}/vacancies/{vacancy_id} вернёт вакансию с идентификатором {vacancy_id}

{
    "id": 4531,
    "position": "Менеджер по продажам",
    "deadline": "2017-04-27",
    "applicants_to_hire": 1,
    "created": "2017-03-22T18:16:27+03:00",
    "priority": 0,
    "state": "OPEN",
    "body": "Обязанности",
    "requirements": "Требования",
    "conditions": "Условия работы",
    "client": 1,
    "files": [
        {
            "id": 15808,
            "name": "Снимок экрана 2017-04-10 в 11.00.13.png",
            "content_type": "image/png",
            "url": "https://store.huntflow.ru/uploads/f/f/h/ffhov94xuqytbl16u8b9l3oeewdjpyoc.png"
        }
    ],
    "contacts": [
        {
            "birthday": null,
            "cell_phone": null,
            "client": 1,
            "comment": null,
            "created": "2017-03-22T18:16:27",
            "email": "[email protected]",
            "first_name": null,
            "id": 2,
            "last_name": "Test",
            "middle_name": null,
            "position": null,
            "removed": null,
            "skype": null,
            "work_phone": null
        }
    ]
}

Поля с результатом аналогичны данным из списка вакансий плюс поля:

Имя Тип Описание
body string Обязанности в формате HTML
requirements string Требования в формате HTML
conditions string Условия работы в формате HTML
files array Список файлов, прикрепленных к вакансии
client number Идентификатор клиента
contacts array Список контактных лиц