Farpost Employer API (1.0.0)

Download OpenAPI specification :

API для работы с вакансиями и откликами на вакансии

Просмотр списка опубликованных вакансий работодателя

Возвращает список идентификаторов опубликовынных вакансий и ограниченный набор полей. Вакансии будут отсортированы по дате изменения. Максимальное число возвращаемых элементов — 100. Если запрос выполняется от лица дочернего кабинета, вернутся только вакансии, назначенные на него.

Authorizations:
OauthToken
query Parameters
modifiedAfter
string <date-time >

Возвращать вакансии с датой изменения от указанной даты. Если не передан — вернутся все вакансии.

cursor
string

Курсор из предыдущего запроса для получения следующей страницы

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "nextCursor": "string"
}

Просмотр данных вакансии

Возвращает полный набор данных вакансий

Authorizations:
OauthToken
path Parameters
vacancyId
required
integer

Идентификатор вакансии

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "dateCreated": "2019-08-24T14:15:22Z",
  • "dateModified": "2019-08-24T14:15:22Z",
  • "url": "string",
  • "firmTitle": "string",
  • "jobPlacement": "string",
  • "jobObligation": "string",
  • "employment": [
    ],
  • "jobRequirements": "string",
  • "salaryMin": 0,
  • "salaryMax": 0,
  • "salaryDescription": "string",
  • "text": "string",
  • "professionalArea": [
    ],
  • "vacancyExtra": [
    ],
  • "driverLicenseCategory": [
    ],
  • "education": {
    },
  • "experience": {
    },
  • "type": "string",
  • "contacts": {
    },
  • "district": "string",
  • "city": {
    }
}

Просмотр списка откликов по вакансии

Возвращает список идентификаторов откликов по вакансии и ограниченный набор полей. Отклики будут отсортированы по дате изменения. Максимальное число возвращаемых элементов — 100.

Authorizations:
OauthToken
path Parameters
vacancyId
required
integer

Идентификатор вакансии

query Parameters
modifiedAfter
string <date-time >

Возвращать отклики с датой изменения от указанной даты. Если не передан — вернутся все отклики.

cursor
string

Курсор из предыдущего запроса для получения следующей страницы

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "nextCursor": "string"
}

Просмотр данных отклика

Возвращает полный набор полей для отклика соискателя на вакансию

Authorizations:
OauthToken
path Parameters
vacancyResponseId
required
integer <int32 >

Идентификатор отклика на вакансию

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "status": "string",
  • "dateModified": "2019-08-24T14:15:22Z",
  • "responseType": "simple_response",
  • "applicantData": {
    }
}

Список всех возможных действий, применимых к откликам

Authorizations:
OauthToken

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Применение действия к отклику

Authorizations:
OauthToken
path Parameters
action
required
string (VacancyResponseActionCode )
Enum: "view" "accept" "invite" "reject" "markAsContacted"

Применяемое действие. Получить список возможных действий можно, используя метод GET /api/job/dict/vacancy-response-actions

vacancyResponseId
required
integer

Идентификатор отклика на вакансию

Request Body schema: application/json
optional
message
string

Текст сообщения, которое будет отправлено соискателю после применении действия к отклику. Требуется для следующих действий:

  • accept
  • invite
  • reject

Если не передан, будет использован текст из шаблона, настроенного в личном кабинете.

Responses

Request samples

Content type
application/json
{
  • "message": "string"
}

Response samples

Content type
application/json
{
  • "errorCode": "string",
  • "errorDescription": "string"
}