Справочники

Справочники используются для заполнения справочных полей в запросах. Например, при создании кандидатов со структурированным резюме. Все справочники доступны через корневой query dictionaries.

Получение всех справочников

Для получения всех доступных справочников можно выполнить следующий запрос:

graphql

query Dictionaries {
  dictionaries {
    areas {
      items {
        id
        name
        parentId
      }
    }
    employments {
      items {
        id
        name
      }
    }
    schedules {
      items {
        id
        name
      }
    }
    languages {
      items {
        id
        name
        parentId
        level {
          id
          name
        }
      }
    }
    industries {
      items {
        id
        name
        parentId
      }
    }
    businessTripReadinesses {
      items {
        id
        name
      }
    }
    travelTimes {
      items {
        id
        name
      }
    }
    relocationTypes {
      items {
        id
        name
      }
    }
    educationLevels {
      items {
        id
        name
      }
    }
    languageLevels {
      items {
        id
        name
      }
    }
  }
}

cURL

curl https://api.talantix.ru/graphql \
 -X POST \
-H "Content-Type: application/json" \
-H "User-Agent: api-doc-agent" \
-H "Authorization: Bearer <your access token>" \
-d "{\"query\":\"query Dictionaries {\\n  dictionaries {\\n    areas {\\n      items {\\n        id\\n        name\\n        parentId\\n      }\\n    }\\n    employments {\\n      items {\\n        id\\n        name\\n      }\\n    }\\n    schedules {\\n      items {\\n        id\\n        name\\n      }\\n    }\\n    languages {\\n      items {\\n        id\\n        name\\n        parentId\\n        level {\\n          id\\n          name\\n        }\\n      }\\n    }\\n    industries {\\n      items {\\n        id\\n        name\\n        parentId\\n      }\\n    }\\n    businessTripReadinesses {\\n      items {\\n        id\\n        name\\n      }\\n    }\\n    travelTimes {\\n      items {\\n        id\\n        name\\n      }\\n    }\\n    relocationTypes {\\n      items {\\n        id\\n        name\\n      }\\n    }\\n    educationLevels {\\n      items {\\n        id\\n        name\\n      }\\n    }\\n    languageLevels {\\n      items {\\n        id\\n        name\\n      }\\n    }\\n  }\\n}\"}"

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

Результат запроса

{
  "data": {
    "dictionaries": {
      "areas": {
        "items": [
          { "id": "123", "name": "Город N", "parentId": "456" },
          { "id": "456", "name": "Страна X", "parentId": null }
        ]
      },
      "employments": {
        "items": [
          { "id": "abc", "name": "Тип занятости 1" },
          { "id": "def", "name": "Тип занятости 2" }
        ]
      },
      "schedules": {
        "items": [
          { "id": "abc", "name": "График работы 1" },
          { "id": "def", "name": "График работы 2" }
        ]
      },
      "languages": {
        "items": [
          { "id": "10", "name": "Язык 1", "parentId": null },
          { "id": "20", "name": "Язык 2", "parentId": null }
        ]
      },
      "industries": {
        "items": [{ "id": "100", "name": "Отрасль 1", "parentId": null }]
      },
      "businessTripReadinesses": {
        "items": [{ "id": "abc", "name": "Готовность к командировкам 1" }]
      },
      "travelTimes": {
        "items": [{ "id": "abc", "name": "Время в пути 1" }]
      },
      "relocationTypes": {
        "items": [{ "id": "abc", "name": "Тип релокации 1" }]
      },
      "educationLevels": {
        "items": [
          { "id": "abc", "name": "Уровень образования 1" },
          { "id": "def", "name": "Уровень образования 2" }
        ]
      },
      "languageLevels": {
        "items": [
          { "id": "10", "name": "Уровень языка 1" },
          { "id": "20", "name": "Уровень языка 2" }
        ]
      }
    }
  }
}

Регионы

Элементы справочника areas имеют иерархическую структуру. Поле parentId указывает на родительский элемент:

• Элементы с parentId: null - страны
• Элементы с parentId — города и регионы внутри страны

Чтобы получить только гражданства (страны), можно использовать параметр onlyCitizenships:

graphql

query DictionariesAreas {
  dictionaries {
    areas(onlyCitizenships: true) {
      items {
        id
        name
      }
    }
  }
}

cURL

curl https://api.talantix.ru/graphql \
 -X POST \
-H "Content-Type: application/json" \
-H "User-Agent: api-doc-agent" \
-H "Authorization: Bearer <your access token>" \
-d "{\"query\":\"query DictionariesAreas {\\n  dictionaries {\\n    areas(onlyCitizenships: true) {\\n      items {\\n        id\\n        name\\n      }\\n    }\\n  }\\n}\"}"

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

подсказка

Все справочники, возвращающие элементы типа Dictionary, имеют поля:

• id — идентификатор элемента справочника
• name — отображаемое название
• parentId — идентификатор родительского элемента (может быть null)