Управление вакансией

Создание вакансии

POST /v1/orders/vacancy/

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

Пояснения:

* - Поля “Сфера деятельности” и “Сфера деятельности - подрубрики“ могут быть не заполнены:

• сервис API попытается заполнить значения полей из внутреннего справочника соответствий “должность“ - “сферы деятельности“

• если соответствий должности и сферы деятельности во внутренних справочниках нет, то будет произведён поиск по вакансиям клиента и будет подобрана наиболее подходящая - сферы деятельности будут взяты из неё

• если не нашли никаких соответствий, то будет возвращена ошибка валидации об обязательности полей “Сфера деятельности” и “Сфера деятельности - подрубрики“

** - поля будут взяты из привязанной сущности “Компания”, если не заполнены

Процесс создания вакансии:

1. Создать компанию либо использовать идентификатор уже созданной компании

2. Получить идентификаторы для сфер деятельности вакансии

3. Заполнить поля и отправить запрос для создания вакансии

 Результат запроса 

• 201 Created - успешное выполнение
• 400 Bad Request - в запросе отсутствуют данные или данные невалидные
• 401 Unauthorized- требуется авторизация

 Пример тела ответа (успешное выполнение) 

{
    "data": {
        "id": 2006267,
        "externalId": "",
        "archive": 0,
        "createdAt": "2020-09-18T19:36:34+03:00",
        "editedAt": "2020-09-18T19:36:34+03:00",
        "archivedAt": null,
        "siteUrl": "https://jobs.jcat.ru/eb8865ba/",
        "reportUrl": null,
        "title": "Должность вакансии",
        "text": "",
        "state": {
            "type": "not_paid",
            "title": "Не оплачено",
            "activatedAt": null,
            "completedAt": null,
            "autoUpdatedAt": {
                "prev": null,
                "next": null,
                "last": null
            },
            "left2end": null,
            "need2prolongate": false,
            "checked": false
        },
        "category": {
            "id": 153,
            "codeName": "post_job",
            "title": "Вакансия на работных сайтах",
            "path": "Вакансии/Вакансия на работных сайтах",
            "breadcrumbs": "153,16,292"
        },
        "tariff": {
            "id": null,
            "title": null,
            "days": null,
            "autoUpdate": null,
            "type": null
        },
        "packet": {
            "id": null,
            "number": null,
            "title": null,
            "createdAt": null,
            "activatedAt": null,
            "completedAt": null,
            "days": null,
            "tariff": {
                "id": null,
                "title": null,
                "days": null,
                "autoUpdate": null,
                "type": null
            }
        },
        "wholesale": null,
        "contacts": {
            "personName": "Тестовый аккаунт 123",
            "email": "mail@jcat.ru",
            "companyName": "Jcat",
            "siteUrl": "https://site.com",
            "phones": {
                "main": {
                    "number": "+79876081174",
                    "additional": ""
                },
                "second": {
                    "number": "+78888888888",
                    "additional": ""
                }
            }
        },
        "address": {
            "fias": {
                "code": "9c89defb-4730-4a62-8d0e-f621d7443949"
            },
            "parts": {
                "region": {
                    "id": 1,
                    "title": "Москва и МО"
                },
                "city": "Троицк",
                "street": "Троицкий бульвар"
            },
            "text": {
                "value": "Москва, Троицк, Троицкий бульвар, д. 1к"
            },
            "house": "1к",
            "housing": "",
            "flat": "",
            "coordinates": {
                "lat": "55.678859",
                "lng": "37.263986"
            }
        },
        "specific": {
            "age_kandidat_ot": "30",
            "age_kandidat_to": "35",
            "amount": {
                "id": "39333",
                "title": "до вычета НДФЛ"
            },
            "assistance_with_relocation_accommodation": "1",
            "company_car": "1",
            "coveralls": "1",
            "driving_license": [
                {
                    "id": "21110,21111",
                    "title": "C"
                }
            ],
            "education": {
                "id": "21096",
                "title": "среднее специальное"
            },
            "education_training": "1",
            "experience": {
                "id": "21101",
                "title": "от 1 до 3 лет"
            },
            "fitness": "1",
            "food": "1",
            "lca": "1",
            "link_to_the_video_on_youtube": "https://www.youtube.com/watch?v=EWddOKrrZf0",
            "medical_book": "1",
            "metro": {
                "id": "40702",
                "title": "Ольховая"
            },
            "mobile_telephony": "1",
            "more_info": "Описание компании",
            "operating_conditions": "Условия работы",
            "passport": "1",
            "post": "Должность вакансии",
            "private_car": "1",
            "qualification_requirements": "Требования <br>",
            "responsibility": "Обязанности",
            "salary_from": "100",
            "salary_to": "1000000",
            "schedule": {
                "id": "21082",
                "title": "сменный график"
            },
            "specializations": [
                {
                    "id": "20451",
                    "title": "Образование, наука"
                }
            ],
            "specializations_subheading": [
                {
                    "id": "20770,25309,20775,20777",
                    "title": "Дошкольное образование и воспитание"
                }
            ],
            "accept_kids": "1",
            "accept_handicapped": "1",
            "travel_petrol": "1",
            "trip": "1",
            "employment": {
                "id": "21075",
                "title": "полная"
            },
            "without_registration_under_labor_code": "0",
            "work_permits": [
                {
                    "id": "40768",
                    "title": "разрешение на работу"
                }
            ]
        },
        "photo": [],
        "vacancyQuestions": []
    }
}

 Пример тела ответа (невалидный запрос) 

{
    "data": {},
    "errors": [
        {
            "type": "system",
            "code": "empty_request",
            "text": "В запросе отсутствуют данные для обработки",
            "field": null,
            "value": null
        }
    ]
}

{
    "data": {},
    "errors": [
        {
            "type": "validation",
            "code": "constraint",
            "text": "Не указано значение для свойства Сфера деятельности",
            "field": "1734",
            "value": ""
        },
        {
            "type": "validation",
            "code": "constraint",
            "text": "Не указано значение для свойства Сфера деятельности - подрубрики",
            "field": "1735",
            "value": ""
        },
        {
            "type": "validation",
            "code": "constraint",
            "text": "Не указано значение для свойства Документы-разрешения на работу",
            "field": "12354",
            "value": ""
        }
    ]
}

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

PUT /v1/orders/vacancy/{vacancy_id}

Редактирование происходит по аналогии с созданием вакансии. При этом есть возможность передачи отдельных параметров для частичного редактирования вакансии.

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

Пояснения:

* - Поля “Сфера деятельности” и “Сфера деятельности - подрубрики“ могут быть не заполнены:

• сервис API попытается заполнить значения полей из внутреннего справочника соответствий “должность“ - “сферы деятельности“

• если соответствий должности и сферы деятельности во внутренних справочниках нет, то будет произведён поиск по вакансиям клиента и будет подобрана наиболее подходящая - сферы деятельности будут взяты из неё

• если не нашли никаких соответствий, то будет возвращена ошибка валидации об обязательности полей “Сфера деятельности” и “Сфера деятельности - подрубрики“

** - Поле "Должность" и "Компания" нельзя изменять после начала публикации вакансии 

 Результат запроса 

• 204 No Content - успешное выполнение
• 400 Bad Request - в запросе отсутствуют данные или данные невалидные
• 401 Unauthorized- требуется авторизация

 Пример тела ответа (успешное выполнение) 

При успешном обновлении вакансии вернется 204 No Content

 Пример тела ответа (невалидный запрос) 

{
    "data": {},
    "errors": [
        {
            "type": "system",
            "code": "empty_request",
            "text": "В запросе отсутствуют данные для обработки",
            "field": null,
            "value": null
        }
    ]
}

{
    "data": {},
    "errors": [
        {
            "type": "validation",
            "code": "constraint",
            "text": "Не указано значение для свойства Сфера деятельности",
            "field": "1734",
            "value": ""
        },
        {
            "type": "validation",
            "code": "constraint",
            "text": "Не указано значение для свойства Сфера деятельности - подрубрики",
            "field": "1735",
            "value": ""
        },
        {
            "type": "validation",
            "code": "constraint",
            "text": "Не указано значение для свойства Документы-разрешения на работу",
            "field": "12354",
            "value": ""
        }
    ]
}

Снятие вакансии с публикации (архивирование)

POST /v1/orders/{id}/unpublish

Обязательные параметры:

 Результат запроса 

• 200 OK - успешное снятие с публикации
• 404 Not Found - вакансия не найдена
• 403 Forbidden - страница недоступна данному пользователю
• 400 Bad Request - ошибка при снятии вакансии с публикации

{
  "data": {
    "result": true
  }
}

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

DELETE /v1/orders/{id}

Обязательные параметры:

Пояснения:

Возможно удаление только снятых с публикации вакансий

Результат запроса 

• 200 OK - успешное удаление
• 404 Not Found - вакансия не найдена
• 403 Forbidden - страница недоступна данному пользователю
• 400 Bad Request - ошибка при удалении вакансии

{
  "data": {
    "result": true
  }
}