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

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

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

Запрос:

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

Параметры:

Имя	Тип	Описание
vacancy_id*	int	Id вакансии для отклика в системе Jcat
full_name*	string	ФИО кандидата
phone*	string	Телефон в формате +7 (*) --*
cv_url	string	Ссылка на резюме. Максимум 255 символов.
about_candidate	string	Сопроводительное письмо. Максимум 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 ОК