Получить публичную вакансию

GET/workforce/careers/postings/{publicSlug}

Возвращает активную опубликованную вакансию с открытой заявкой на подбор и неистёкшим сроком. Публичный ответ содержит сведения об организации и роли, а также версию уведомления о персональных данных для подачи заявки. Авторизация не требуется.

Примеры запросов

Демонстрационные данные. Примеры не отправляют запросы. В своей интеграции подставьте значения, полученные на предыдущих шагах.

cURL

curl --request GET 'https://api.hallify.co/workforce/careers/postings/example'

Пример ответа

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

Пример ответа · 200 · application/json

{
  "publicSlug": "example-slug",
  "organizationName": "Example name",
  "title": "Example title",
  "summary": "Synthetic example",
  "description": "Synthetic example",
  "locationText": "example",
  "privacyNoticeVersion": "example"
}

Авторизация

Учётная запись Hallify не требуется. Соблюдайте предварительные условия и ограничения этого метода.

Руководство по подключению

Параметры

publicSlugПуть · Обязательно: Стабильный публичный slug опубликованной вакансии. Не является ключом кандидата.
string
Полное определение
{ "type": "string", "example": "example" }

Ответы

200Публичные сведения о вакансии, которая сейчас принимает заявки.

PublicCareerPostingDto

Полное определение

{
  "$ref": "#/components/schemas/PublicCareerPostingDto"
}

Пример ответа · 200 · application/json

{
  "publicSlug": "example-slug",
  "organizationName": "Example name",
  "title": "Example title",
  "summary": "Synthetic example",
  "description": "Synthetic example",
  "locationText": "example",
  "privacyNoticeVersion": "example"
}

Схемы

PublicCareerPostingDto

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

publicSlugОбязательно: Публичный slug publicSlug.
string
Полное определение
{ "type": "string", "description": "Публичный slug `publicSlug`.", "example": "example-slug" }
organizationNameОбязательно: Понятное человеку значение organizationName.
string
Полное определение
{ "type": "string", "description": "Понятное человеку значение `organizationName`.", "example": "Example name" }
titleОбязательно: Понятное человеку значение title.
string
Полное определение
{ "type": "string", "description": "Понятное человеку значение `title`.", "example": "Example title" }
summaryОбязательно: Краткое описание summary для человека.
string
Полное определение
{ "type": "string", "description": "Краткое описание `summary` для человека.", "example": "Synthetic example" }
descriptionОбязательно: Понятный человеку текст description.
string
Полное определение
{ "type": "string", "description": "Понятный человеку текст `description`.", "example": "Synthetic example" }
locationTextОбязательно: Описание местоположения locationText.
string
Полное определение
{ "type": "string", "description": "Описание местоположения `locationText`.", "example": "example" }
closesAtНеобязательно: Время события closesAt. Null означает отсутствие записанного значения в этом представлении.
string · date-time · null
Полное определение
{ "type": "string", "nullable": true, "description": "Время события `closesAt`. Null означает отсутствие записанного значения в этом представлении.", "format": "date-time", "example": "2026-01-15T12:00:00.000Z" }
privacyNoticeVersionОбязательно: Версия уведомления о персональных данных privacyNoticeVersion.
string
Полное определение
{ "type": "string", "description": "Версия уведомления о персональных данных `privacyNoticeVersion`.", "example": "example" }

Полное определение

{
  "type": "object",
  "properties": {
    "publicSlug": {
      "type": "string",
      "description": "Публичный slug `publicSlug`.",
      "example": "example-slug"
    },
    "organizationName": {
      "type": "string",
      "description": "Понятное человеку значение `organizationName`.",
      "example": "Example name"
    },
    "title": {
      "type": "string",
      "description": "Понятное человеку значение `title`.",
      "example": "Example title"
    },
    "summary": {
      "type": "string",
      "description": "Краткое описание `summary` для человека.",
      "example": "Synthetic example"
    },
    "description": {
      "type": "string",
      "description": "Понятный человеку текст `description`.",
      "example": "Synthetic example"
    },
    "locationText": {
      "type": "string",
      "description": "Описание местоположения `locationText`.",
      "example": "example"
    },
    "closesAt": {
      "type": "string",
      "nullable": true,
      "description": "Время события `closesAt`. Null означает отсутствие записанного значения в этом представлении.",
      "format": "date-time",
      "example": "2026-01-15T12:00:00.000Z"
    },
    "privacyNoticeVersion": {
      "type": "string",
      "description": "Версия уведомления о персональных данных `privacyNoticeVersion`.",
      "example": "example"
    }
  },
  "required": [
    "publicSlug",
    "organizationName",
    "title",
    "summary",
    "description",
    "locationText",
    "privacyNoticeVersion"
  ],
  "description": "Публичные сведения о вакансии, которая сейчас принимает заявки.",
  "example": {
    "publicSlug": "example-slug",
    "organizationName": "Example name",
    "title": "Example title",
    "summary": "Synthetic example",
    "description": "Synthetic example",
    "locationText": "example",
    "privacyNoticeVersion": "example"
  }
}