Документация API JCat.Работа

Прием откликов

https://vacancy-response.jcat.ru — служит для приема откликов на вакансии от партнеров сервиса


Запрос:

ТипРесурсЗаголовкиОписание
POST/v1/add_responseContent-Type: application/jsonСоздает отклик на вакансию


X-ApiKey: токен авторизации в API

Параметры:

ИмяТипОписание
vacancy_id*intId вакансии для отклика в системе Jcat
full_name*stringФИО кандидата
phone*stringТелефон в формате +7 (***) ***-**-**
cv_urlstringСсылка на резюме.
Максимум 255  символов.
about_candidatestringСопроводительное письмо. Максимум 2000 символов.
birthday
date
Дата рождения кандидата. Формат: YYYY-mm-dd. Пример: 1980-12-31
citizenship
string
Название страны кандидата, гражданином которой он является

* - обязательное поле


Пример запроса:

curl -i -H 'X-ApiKey: 12345' https://vacancy-response.jcat.ru/v1/add_response/ -H 'Content-Type: application/json' -d '{"vacancy_id": 0123456789,"full_name": "Петр Петрович Петров","phone": "+7 (998) 787-23-42"}'


Пример тела запроса:

{
  "vacancy_id": 0123456789,
  "full_name": "Петр Петрович Петров",
  "phone": "+7 (998) 787-23-42",
  "cv_url": "http://test.com/my_cv.pdf",
  "about_candidate": "Сопроводительное письмо"
}


Пример ответа без авторизации:

HTTP/1.1 404 Not Found
Content-Type: application/json;

{
    "error": "No route found for "POST /v1/add_response""
}


Пример ответа с ошибками валидации:

HTTP/1.1 400 Bad Request
Content-Type: application/json;

{
    "data": {},
    "errors": [
        {
            "text": "Поле "ФИО" не может быть пустым",
            "field": "full_name",
            "value": null
        },
        {
            "text": "Поле "Телефон" не может быть пустым",
            "field": "phone",
            "value": null
        },
        {
            "text": "Поле "Id вакансии" не может быть пустым",
            "field": "vacancy_id",
            "value": null
        }
    ]
}


Пример ответа при успешном создании:

HTTP/1.1 200 ОК