Skip to content

Latest commit

 

History

History
225 lines (202 loc) · 7.88 KB

agency_vacancy_requests.md

File metadata and controls

225 lines (202 loc) · 7.88 KB

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

Добавление заявки на вакансию

POST /account/{account_id}/clients/{client_id}/client_vacancy_requests

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

{
    "contacts": [{
        "id": 1
    }],
    "position": "Моя должность",
    "duties": "Мои обязанности",
    "skills": "Мои профессиональные навыки",
    "soft_skills": "Мои личностные качества",
    "langs": "Мои иностранные языки",
    "money": "10000",
    "bonus": "0",
    "fringe_benefits": "Мой социальный пакет",
    "reason": "Новая вакансия",
    "sources": "Мой источник",
    "start_work": "07.12.2019",
    "comment": "Мои комментарии"
}

Поля запроса

  • [] обозначает, что значение данного ключа является массивом
  • a.b обозначает объект a с ключом b
Путь Тип Обязательный Описание
contacts[].id number Да Идентификатор контакта
position string Да Должность
* * * Поля согласно схеме заявки на вакансию

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

GET /account/{account_id}/clients/{client_id}/client_vacancy_requests/{client_vacancy_requests_id} вернёт клиента с идентификатором {client_vacancy_requests_id}

{
    "id": 1,
    "created": "2019-12-12T07:22:39+03:00",
    "position": "Моя должность",
    "contacts": [{
        "id": 1
    }],
    "values": {
        "comment": null,
        "start_work": "07.12.2019",
        "sources": null,
        "skills": "test",
        "money": "111",
        "fringe_benefits": "111",
        "bonus": "111",
        "reason": "Новая вакансия",
        "duties": "test",
        "position": "test",
        "langs": "test",
        "soft_skills": "test"
    },
    "account_info": {
        "email": "[email protected]",
        "id": 1,
        "name": "Manager 1"
    }
}
Имя Тип Описание
id number Идентификатор заявки
created datetime Дата и время создания заявки
position string Должность
contacts[].id number Идентификатор контакта, привязанного к заявке
values object Значение заполненных полей заявки
account_info.id number Идентификатор пользователя, создавшего заявку
account_info.name string Имя пользователя, создавшего заявку
account_info.email string Email пользователя, создавшего заявку

Взятие заявки на вакансию в работу

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

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

DELETE /account/{account_id}/clients/{client_id}/client_vacancy_requests/{client_vacancy_requests_id}

Описание схемы заявки на вакансию

GET /account/{account_id}/account_client_vacancy_requests вернёт список схем заявки на вакансию.

{
    "items": [{
        "account": 1862,
        "name": "",
        "active": true,
        "attendee_hint": null,
        "id": 4,
        "schema": {
            "duties": {
                "title": "Обязанности",
                "required": true,
                "type": "text",
                "order": 2,
                "value": null,
                "id": 38
            },
            "skills": {
                "title": "Профессиональные навыки",
                "required": true,
                "type": "text",
                "order": 3,
                "value": null,
                "id": 39
            },
            "soft_skills": {
                "title": "Личностные качества",
                "required": false,
                "type": "text",
                "order": 4,
                "value": null,
                "id": 40
            },
            "langs": {
                "delimiter": true,
                "title": "Иностранные языки",
                "required": false,
                "type": "text",
                "order": 5,
                "value": null,
                "id": 41
            },
            "money": {
                "title": "Оклад",
                "required": false,
                "type": "string",
                "order": 6,
                "value": null,
                "id": 42
            },
            "bonus": {
                "title": "Бонус",
                "required": false,
                "type": "string",
                "order": 7,
                "value": null,
                "id": 43
            },
            "fringe_benefits": {
                "delimiter": true,
                "title": "Социальный пакет",
                "required": false,
                "type": "string",
                "order": 8,
                "value": null,
                "id": 44
            },
            "reason": {
                "values": [
                    "Новая вакансия",
                    "Замена текущего сотрудника",
                    "Повышение текущего сотрудника"
                ],
                "title": "Причины открытия вакансии",
                "required": true,
                "type": "select",
                "order": 9,
                "value": null,
                "id": 45
            },
            "sources": {
                "title": "Источники поиска (компании, конкуренты)",
                "required": false,
                "type": "text",
                "order": 10,
                "value": null,
                "id": 46
            },
            "start_work": {
                "title": "Ожидаемая дата начала работы кандидата",
                "required": true,
                "type": "date",
                "order": 11,
                "value": null,
                "id": 47
            },
            "comment": {
                "title": "Комментарии",
                "required": false,
                "type": "text",
                "order": 12,
                "value": null,
                "id": 48
            }
        }
    }]
}
Имя Тип Описание
id number Идентификатор схемы заявки
name string Название схемы
active bool Флаг активности схемы
schema object Описание полей схемы