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

Удаление, восстановление и объединение кандидатов

Удаление кандидатов​

Удалить кандидатов можно с помощью следующего запроса. Удалённые кандидаты пропадают из обычных списков и могут быть восстановлены мутацией restorePersons.

mutation DeletePersons {
  deletePersons(personIds: [2937738, 2937739]) {
    __typename
    ... on PersonsDeletedSuccess {
      message
    }
    ... on PersonsDeleteError {
      errorType
      message
    }
  }
}

Посмотреть в playground

подсказка

Поле personIds заполняется идентификаторами кандидатов.

Кандидаты — примеры получения списка доступных кандидатов

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

{
  "data": {
    "deletePersons": {
      "__typename": "PersonsDeletedSuccess",
      "message": null
    }
  }
}

В случае ошибки вернётся json с типом ошибки

{
  "data": {
    "deletePersons": {
      "__typename": "PersonsDeleteError",
      "errorType": "ACCESS_DENIED",
      "message": null
    }
  }
}

Возможные типы ошибок:

  • ACCESS_DENIED — нет доступа к одному из кандидатов
  • PERSONS_NOT_FOUND — один из кандидатов не найден

Восстановление кандидатов​

Восстановить ранее удалённых кандидатов можно с помощью следующего запроса

mutation RestorePersons {
  restorePersons(personIds: [2937738, 2937739]) {
    __typename
    ... on PersonsRestoredSuccess {
      message
    }
    ... on PersonsRestoreError {
      errorType
      message
    }
  }
}

Посмотреть в playground

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

{
  "data": {
    "restorePersons": {
      "__typename": "PersonsRestoredSuccess",
      "message": null
    }
  }
}

В случае ошибки вернётся json с типом ошибки

{
  "data": {
    "restorePersons": {
      "__typename": "PersonsRestoreError",
      "errorType": "PERSONS_NOT_FOUND",
      "message": null
    }
  }
}

Возможные типы ошибок:

  • ACCESS_DENIED — нет доступа к одному из кандидатов
  • PERSONS_NOT_FOUND — один из кандидатов не найден

Объединение кандидатов​

Объединить несколько карточек кандидата в одну можно с помощью следующего запроса. В результате останется один кандидат; его идентификатор возвращается в поле mergeResultId.

mutation MergePersons {
  mergePersons(personIds: [2937738, 2937739]) {
    __typename
    ... on PersonsMergedSuccess {
      mergeResultId
    }
    ... on PersonsMergeError {
      errorType
      message
    }
  }
}

Посмотреть в playground

примечание

Для объединения нужно передать не менее двух идентификаторов кандидатов.

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

{
  "data": {
    "mergePersons": {
      "__typename": "PersonsMergedSuccess",
      "mergeResultId": 2937738
    }
  }
}

В случае ошибки вернётся json с типом ошибки

{
  "data": {
    "mergePersons": {
      "__typename": "PersonsMergeError",
      "errorType": "INVALID_PERSONS_COUNT",
      "message": null
    }
  }
}

Возможные типы ошибок:

  • ACCESS_DENIED — нет доступа к одному из кандидатов
  • INVALID_PERSONS_COUNT — недопустимое количество кандидатов для объединения
  • PERSONS_NOT_FOUND — один из кандидатов не найден