Внимание, данная документация актуальна на момент версии 2.20 и может не содержать более свежих изменений, см. api.superjob.ru/doc/
Доступ к API работодателя предоставляется платно. Размер лицензионного вознаграждения за право использования API Superjob для Работодателей Базы данных указан в прайс-листе.
Свяжитесь с нами для справок по тарифам.
Заказать обратный звонок
Общие положения. Авторизация.

Все данные доступны в API для соискателя

Блокировка

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

Заблокирована вся компания
{
    "error":{
        "code":403,
        "message":"Ваша регистрация заблокирована",
        "errors":[{
            "reason":"client_blocked",
            "reason_text":"Клиент-работодатель заблокирован администрацией"
        }]
    }
}
Пользователь заблокирован администрацией
{
    "error":{
        "code":403,
        "message":"Ваша регистрация заблокирована",
        "errors":[{
            "reason":"user_blocked_by_admin",
            "reason_text":"Пользователь заблокирован администрацией"
        }]
    }
}
Пользователь заблокирован другим пользователем компании
{
    "error":{
        "code":403,
        "message":"Ваша регистрация заблокирована",
        "errors":[{
            "reason":"user_blocked_by_other_user",
            "reason_text":"Пользователь заблокирован другим пользователем",
            "user_name":"Виктория Ивановна Иванова"
        }]
    }
}

где в объекте errors можно узнать текстовое описание причины блокировки (поле reason_text), метку блокировки (поле reason) и ФИО пользователя, установившего блокировку (user_name).

Поддержка пакетной обработки данных

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

Запрос

При наличии в методе поддержки пакетной обработки, должен быть особым образом передан запрос. Запрос должен содержать массив элементов. Каждый элемент должен содержать все те данные, что передаются в случае обычного запроса. Например:


POST = array(
    'vacancies' => array(
        array('profession' => 'Developer', ... // содержимое вакансии),
        array('profession' => 'Axapta Developer', ... // содержимое вакансии), //....
    ),
)

Создание вакансии

POST /2.0/vacancies/ HTTP/1.1
        Host: api.superjob.ru
        X-Api-App-Id: yourAppSecretKey
        Content-Type: application/x-www-form-urlencoded
        Authorization: Bearer h.000000000000001.example.token

        vacancies%5B0%5D%5Bpublished%5D=0&vacancies%5B0%5D%5Btown%5D=4&vacancies%5B0%5D%5Bmoveable%5D=1&vacancies%5B0%5D%5Bold1%5D=22&vacancies%5B0%5D%5Bold2%5D=99&vacancies%5B0%5D%5Bpol%5D=2&vacancies%5B0%5D%5Bpayment_from%5D=27432&vacancies%5B0%5D%5Bpayment_to%5D=214035&vacancies%5B0%5D%5Btype_of_work%5D=13&vacancies%5B0%5D%5Bplace_of_work%5D=1&vacancies%5B0%5D%5Beducation%5D=3&vacancies%5B0%5D%5Bdrive_license%5D%5B0%5D=A&vacancies%5B0%5D%5Bdrive_license%5D%5B1%5D=B&vacancies%5B0%5D%5Bdrive_license%5D%5B2%5D=C&vacancies%5B0%5D%5Bdrive_license%5D%5B3%5D=D&vacancies%5B0%5D%5Bdrive_license%5D%5B4%5D=E&vacancies%5B0%5D%5Bprofession%5D=UI-web+designer1407938033.7986&vacancies%5B0%5D%5Bcode%5D=616516&vacancies%5B0%5D%5Bwork%5D=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD+%D0%B8+%D0%BF%D1%80%D0%BE%D1%87%D0%B8%D0%B5+%D0%BE%D0%B1%D1%8F%D0%B7%D0%B0%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D0%B8&vacancies%5B0%5D%5Bcompensation%5D=%D0%9F%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9+%D1%81%D0%BE%D1%86%D0%BF%D0%B0%D0%BA%D0%B5%D1%82&vacancies%5B0%5D%5Burl%5D=www.example.ru&vacancies%5B0%5D%5Bmail%5D=example%40mail.ru&vacancies%5B0%5D%5Bname%5D=%D0%9E%D0%9E%D0%9E+%D0%92%D0%B5%D0%BA%D1%82%D0%BE%D1%80&vacancies%5B0%5D%5Bcontact%5D=%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2+%D0%98%D0%B2%D0%B0%D0%BD&vacancies%5B0%5D%5Bcompany%5D=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD-%D1%81%D1%82%D1%83%D0%B4%D0%B8%D1%8F.&vacancies%5B0%5D%5Bcandidat%5D=%D0%92%D0%B5%D1%80%D1%81%D1%82%D0%BA%D0%B0+%D0%B8+%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5+%D0%BC%D0%B0%D0%BA%D0%B5%D1%82%D0%BE%D0%B2+%D0%B4%D0%BB%D1%8F+%D0%B6%D1%83%D1%80%D0%BD%D0%B0%D0%BB%D0%BE%D0%B2&vacancies%5B0%5D%5Bmaritalstatus%5D=2&vacancies%5B0%5D%5Bchildren%5D=3&vacancies%5B0%5D%5Baddress%5D=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0%2C+%D0%9C%D0%B0%D0%BB%D1%8B%D0%B9+%D0%BF%D0%B5%D1%80%D0%B5%D1%83%D0%BB%D0%BE%D0%BA%2C+%D0%B4.+2&vacancies%5B0%5D%5Brefresh_vac%5D=1&vacancies%5B0%5D%5Banonymous%5D=0&vacancies%5B0%5D%5Bmetro%5D%5B0%5D=120&vacancies%5B0%5D%5Bmetro%5D%5B1%5D=2&vacancies%5B0%5D%5Bcatalogues%5D%5B0%5D=500&vacancies%5B0%5D%5Bcatalogues%5D%5B1%5D=93&vacancies%5B0%5D%5Bcatalogues%5D%5B2%5D=217&vacancies%5B0%5D%5Bcatalogues%5D%5B3%5D=98&vacancies%5B0%5D%5Bcatalogues%5D%5B4%5D=289&vacancies%5B0%5D%5Bexperience%5D=3&vacancies%5B0%5D%5Bresumesubscription_status%5D=0&vacancies%5B0%5D%5Bresumesubscription_kwc%5D=or&vacancies%5B0%5D%5Bresumesubscription_rws%5D=7&vacancies%5B0%5D%5Bphones%5D%5B0%5D%5Badditional%5D=456654&vacancies%5B0%5D%5Bphones%5D%5B0%5D%5Bcountry_code%5D=7&vacancies%5B0%5D%5Bphones%5D%5B0%5D%5Bcity_code%5D=495&vacancies%5B0%5D%5Bphones%5D%5B0%5D%5Bnumber%5D=7907277&vacancies%5B0%5D%5Blanguages%5D%5B0%5D%5Blevel%5D=5&vacancies%5B0%5D%5Blanguages%5D%5B0%5D%5Bid_language%5D=1&vacancies%5B1%5D%5Bpublished%5D=0&vacancies%5B1%5D%5Btown%5D=4&vacancies%5B1%5D%5Bmoveable%5D=1&vacancies%5B1%5D%5Bold1%5D=22&vacancies%5B1%5D%5Bold2%5D=99&vacancies%5B1%5D%5Bpol%5D=2&vacancies%5B1%5D%5Bpayment_from%5D=29462&vacancies%5B1%5D%5Bpayment_to%5D=223857&vacancies%5B1%5D%5Btype_of_work%5D=13&vacancies%5B1%5D%5Bplace_of_work%5D=1&vacancies%5B1%5D%5Beducation%5D=3&vacancies%5B1%5D%5Bdrive_license%5D%5B0%5D=A&vacancies%5B1%5D%5Bdrive_license%5D%5B1%5D=B&vacancies%5B1%5D%5Bdrive_license%5D%5B2%5D=C&vacancies%5B1%5D%5Bdrive_license%5D%5B3%5D=D&vacancies%5B1%5D%5Bdrive_license%5D%5B4%5D=E&vacancies%5B1%5D%5Bprofession%5D=UI-web+designer1407938033.7986&vacancies%5B1%5D%5Bcode%5D=616516&vacancies%5B1%5D%5Bwork%5D=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD+%D0%B8+%D0%BF%D1%80%D0%BE%D1%87%D0%B8%D0%B5+%D0%BE%D0%B1%D1%8F%D0%B7%D0%B0%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D0%B8&vacancies%5B1%5D%5Bcompensation%5D=%D0%9F%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9+%D1%81%D0%BE%D1%86%D0%BF%D0%B0%D0%BA%D0%B5%D1%82&vacancies%5B1%5D%5Burl%5D=www.example.ru&vacancies%5B1%5D%5Bmail%5D=example%40mail.ru&vacancies%5B1%5D%5Bname%5D=%D0%9E%D0%9E%D0%9E+%D0%92%D0%B5%D0%BA%D1%82%D0%BE%D1%80&vacancies%5B1%5D%5Bcontact%5D=%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2+%D0%98%D0%B2%D0%B0%D0%BD&vacancies%5B1%5D%5Bcompany%5D=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD-%D1%81%D1%82%D1%83%D0%B4%D0%B8%D1%8F.&vacancies%5B1%5D%5Bcandidat%5D=%D0%92%D0%B5%D1%80%D1%81%D1%82%D0%BA%D0%B0+%D0%B8+%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5+%D0%BC%D0%B0%D0%BA%D0%B5%D1%82%D0%BE%D0%B2+%D0%B4%D0%BB%D1%8F+%D0%B6%D1%83%D1%80%D0%BD%D0%B0%D0%BB%D0%BE%D0%B2&vacancies%5B1%5D%5Bmaritalstatus%5D=2&vacancies%5B1%5D%5Bchildren%5D=3&vacancies%5B1%5D%5Baddress%5D=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0%2C+%D0%9C%D0%B0%D0%BB%D1%8B%D0%B9+%D0%BF%D0%B5%D1%80%D0%B5%D1%83%D0%BB%D0%BE%D0%BA%2C+%D0%B4.+2&vacancies%5B1%5D%5Brefresh_vac%5D=1&vacancies%5B1%5D%5Banonymous%5D=0&vacancies%5B1%5D%5Bmetro%5D%5B0%5D=120&vacancies%5B1%5D%5Bmetro%5D%5B1%5D=2&vacancies%5B1%5D%5Bcatalogues%5D%5B0%5D=158&vacancies%5B1%5D%5Bcatalogues%5D%5B1%5D=82&vacancies%5B1%5D%5Bcatalogues%5D%5B2%5D=286&vacancies%5B1%5D%5Bcatalogues%5D%5B3%5D=184&vacancies%5B1%5D%5Bcatalogues%5D%5B4%5D=46&vacancies%5B1%5D%5Bexperience%5D=3&vacancies%5B1%5D%5Bresumesubscription_status%5D=0&vacancies%5B1%5D%5Bresumesubscription_kwc%5D=or&vacancies%5B1%5D%5Bresumesubscription_rws%5D=7&vacancies%5B1%5D%5Bphones%5D%5B0%5D%5Badditional%5D=456654&vacancies%5B1%5D%5Bphones%5D%5B0%5D%5Bcountry_code%5D=7&vacancies%5B1%5D%5Bphones%5D%5B0%5D%5Bcity_code%5D=495&vacancies%5B1%5D%5Bphones%5D%5B0%5D%5Bnumber%5D=7907277&vacancies%5B1%5D%5Blanguages%5D%5B0%5D%5Blevel%5D=5&vacancies%5B1%5D%5Blanguages%5D%5B0%5D%5Bid_language%5D=1&turbo=1

                        

Для пакетного обновления нужно использовать ту же структуру запроса, за исключением того факта, что в каждом массиве дожен так же находиться ключ с id сущности:

Обновление вакансии

PUT /2.0/vacancies/ HTTP/1.1
        Host: api.superjob.ru
        X-Api-App-Id: yourAppSecretKey
        Content-Type: application/x-www-form-urlencoded
        Authorization: Bearer h.000000000000001.example.token

        vacancies%5B0%5D%5Bid%5D=27104108&vacancies%5B0%5D%5Bpublished%5D=0&vacancies%5B0%5D%5Btown%5D=4&vacancies%5B0%5D%5Bmoveable%5D=1&vacancies%5B0%5D%5Bold1%5D=22&vacancies%5B0%5D%5Bold2%5D=99&vacancies%5B0%5D%5Bpol%5D=2&vacancies%5B0%5D%5Bpayment_from%5D=27432&vacancies%5B0%5D%5Bpayment_to%5D=214035&vacancies%5B0%5D%5Btype_of_work%5D=13&vacancies%5B0%5D%5Bplace_of_work%5D=1&vacancies%5B0%5D%5Beducation%5D=3&vacancies%5B0%5D%5Bdrive_license%5D%5B0%5D=A&vacancies%5B0%5D%5Bdrive_license%5D%5B1%5D=B&vacancies%5B0%5D%5Bdrive_license%5D%5B2%5D=C&vacancies%5B0%5D%5Bdrive_license%5D%5B3%5D=D&vacancies%5B0%5D%5Bdrive_license%5D%5B4%5D=E&vacancies%5B0%5D%5Bprofession%5D=Changed+27104108&vacancies%5B0%5D%5Bcode%5D=616516&vacancies%5B0%5D%5Bwork%5D=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD+%D0%B8+%D0%BF%D1%80%D0%BE%D1%87%D0%B8%D0%B5+%D0%BE%D0%B1%D1%8F%D0%B7%D0%B0%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D0%B8&vacancies%5B0%5D%5Bcompensation%5D=%D0%9F%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9+%D1%81%D0%BE%D1%86%D0%BF%D0%B0%D0%BA%D0%B5%D1%82&vacancies%5B0%5D%5Burl%5D=www.example.ru&vacancies%5B0%5D%5Bmail%5D=example%40mail.ru&vacancies%5B0%5D%5Bname%5D=%D0%9E%D0%9E%D0%9E+%D0%92%D0%B5%D0%BA%D1%82%D0%BE%D1%80&vacancies%5B0%5D%5Bcontact%5D=%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2+%D0%98%D0%B2%D0%B0%D0%BD&vacancies%5B0%5D%5Bcompany%5D=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD-%D1%81%D1%82%D1%83%D0%B4%D0%B8%D1%8F.&vacancies%5B0%5D%5Bcandidat%5D=%D0%92%D0%B5%D1%80%D1%81%D1%82%D0%BA%D0%B0+%D0%B8+%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5+%D0%BC%D0%B0%D0%BA%D0%B5%D1%82%D0%BE%D0%B2+%D0%B4%D0%BB%D1%8F+%D0%B6%D1%83%D1%80%D0%BD%D0%B0%D0%BB%D0%BE%D0%B2&vacancies%5B0%5D%5Bmaritalstatus%5D=2&vacancies%5B0%5D%5Bchildren%5D=3&vacancies%5B0%5D%5Baddress%5D=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0%2C+%D0%9C%D0%B0%D0%BB%D1%8B%D0%B9+%D0%BF%D0%B5%D1%80%D0%B5%D1%83%D0%BB%D0%BE%D0%BA%2C+%D0%B4.+2&vacancies%5B0%5D%5Brefresh_vac%5D=1&vacancies%5B0%5D%5Banonymous%5D=0&vacancies%5B0%5D%5Bmetro%5D%5B0%5D=120&vacancies%5B0%5D%5Bmetro%5D%5B1%5D=2&vacancies%5B0%5D%5Bcatalogues%5D%5B0%5D=500&vacancies%5B0%5D%5Bcatalogues%5D%5B1%5D=93&vacancies%5B0%5D%5Bcatalogues%5D%5B2%5D=217&vacancies%5B0%5D%5Bcatalogues%5D%5B3%5D=98&vacancies%5B0%5D%5Bcatalogues%5D%5B4%5D=289&vacancies%5B0%5D%5Bexperience%5D=3&vacancies%5B0%5D%5Bresumesubscription_status%5D=0&vacancies%5B0%5D%5Bresumesubscription_kwc%5D=or&vacancies%5B0%5D%5Bresumesubscription_rws%5D=7&vacancies%5B0%5D%5Bphones%5D%5B0%5D%5Badditional%5D=456654&vacancies%5B0%5D%5Bphones%5D%5B0%5D%5Bcountry_code%5D=7&vacancies%5B0%5D%5Bphones%5D%5B0%5D%5Bcity_code%5D=495&vacancies%5B0%5D%5Bphones%5D%5B0%5D%5Bnumber%5D=7907277&vacancies%5B0%5D%5Blanguages%5D%5B0%5D%5Blevel%5D=5&vacancies%5B0%5D%5Blanguages%5D%5B0%5D%5Bid_language%5D=1&vacancies%5B1%5D%5Bid%5D=27104109&vacancies%5B1%5D%5Bpublished%5D=0&vacancies%5B1%5D%5Btown%5D=4&vacancies%5B1%5D%5Bmoveable%5D=1&vacancies%5B1%5D%5Bold1%5D=22&vacancies%5B1%5D%5Bold2%5D=99&vacancies%5B1%5D%5Bpol%5D=2&vacancies%5B1%5D%5Bpayment_from%5D=29462&vacancies%5B1%5D%5Bpayment_to%5D=223857&vacancies%5B1%5D%5Btype_of_work%5D=13&vacancies%5B1%5D%5Bplace_of_work%5D=1&vacancies%5B1%5D%5Beducation%5D=3&vacancies%5B1%5D%5Bdrive_license%5D%5B0%5D=A&vacancies%5B1%5D%5Bdrive_license%5D%5B1%5D=B&vacancies%5B1%5D%5Bdrive_license%5D%5B2%5D=C&vacancies%5B1%5D%5Bdrive_license%5D%5B3%5D=D&vacancies%5B1%5D%5Bdrive_license%5D%5B4%5D=E&vacancies%5B1%5D%5Bprofession%5D=Changed+27104109&vacancies%5B1%5D%5Bcode%5D=616516&vacancies%5B1%5D%5Bwork%5D=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD+%D0%B8+%D0%BF%D1%80%D0%BE%D1%87%D0%B8%D0%B5+%D0%BE%D0%B1%D1%8F%D0%B7%D0%B0%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D0%B8&vacancies%5B1%5D%5Bcompensation%5D=%D0%9F%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9+%D1%81%D0%BE%D1%86%D0%BF%D0%B0%D0%BA%D0%B5%D1%82&vacancies%5B1%5D%5Burl%5D=www.example.ru&vacancies%5B1%5D%5Bmail%5D=example%40mail.ru&vacancies%5B1%5D%5Bname%5D=%D0%9E%D0%9E%D0%9E+%D0%92%D0%B5%D0%BA%D1%82%D0%BE%D1%80&vacancies%5B1%5D%5Bcontact%5D=%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2+%D0%98%D0%B2%D0%B0%D0%BD&vacancies%5B1%5D%5Bcompany%5D=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD-%D1%81%D1%82%D1%83%D0%B4%D0%B8%D1%8F.&vacancies%5B1%5D%5Bcandidat%5D=%D0%92%D0%B5%D1%80%D1%81%D1%82%D0%BA%D0%B0+%D0%B8+%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5+%D0%BC%D0%B0%D0%BA%D0%B5%D1%82%D0%BE%D0%B2+%D0%B4%D0%BB%D1%8F+%D0%B6%D1%83%D1%80%D0%BD%D0%B0%D0%BB%D0%BE%D0%B2&vacancies%5B1%5D%5Bmaritalstatus%5D=2&vacancies%5B1%5D%5Bchildren%5D=3&vacancies%5B1%5D%5Baddress%5D=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0%2C+%D0%9C%D0%B0%D0%BB%D1%8B%D0%B9+%D0%BF%D0%B5%D1%80%D0%B5%D1%83%D0%BB%D0%BE%D0%BA%2C+%D0%B4.+2&vacancies%5B1%5D%5Brefresh_vac%5D=1&vacancies%5B1%5D%5Banonymous%5D=0&vacancies%5B1%5D%5Bmetro%5D%5B0%5D=120&vacancies%5B1%5D%5Bmetro%5D%5B1%5D=2&vacancies%5B1%5D%5Bcatalogues%5D%5B0%5D=158&vacancies%5B1%5D%5Bcatalogues%5D%5B1%5D=82&vacancies%5B1%5D%5Bcatalogues%5D%5B2%5D=286&vacancies%5B1%5D%5Bcatalogues%5D%5B3%5D=184&vacancies%5B1%5D%5Bcatalogues%5D%5B4%5D=46&vacancies%5B1%5D%5Bexperience%5D=3&vacancies%5B1%5D%5Bresumesubscription_status%5D=0&vacancies%5B1%5D%5Bresumesubscription_kwc%5D=or&vacancies%5B1%5D%5Bresumesubscription_rws%5D=7&vacancies%5B1%5D%5Bphones%5D%5B0%5D%5Badditional%5D=456654&vacancies%5B1%5D%5Bphones%5D%5B0%5D%5Bcountry_code%5D=7&vacancies%5B1%5D%5Bphones%5D%5B0%5D%5Bcity_code%5D=495&vacancies%5B1%5D%5Bphones%5D%5B0%5D%5Bnumber%5D=7907277&vacancies%5B1%5D%5Blanguages%5D%5B0%5D%5Blevel%5D=5&vacancies%5B1%5D%5Blanguages%5D%5B0%5D%5Bid_language%5D=1&turbo=0
                        

Наконец, для пакетного совершения операций, которые требуют только id сущности, необходимо сделать запрос с такой же структурой, но с id сущности в качестве элементов массива:


POST = array(
    'vacancies' => array(
        1000000003, // id вакансии
        1000000004, //....
    ),
)

Перевод вакансии в архив

PUT /2.0/vacancies/archive/ HTTP/1.1
        Host: api.superjob.ru
        X-Api-App-Id: yourAppSecretKey
        Content-Type: application/x-www-form-urlencoded
        Authorization: Bearer h.000000000000001.example.token

        vacancies%5B0%5D=234234&vacancies%5B1%5D=3242345&vacancies%5B2%5D=45453345&vacancies%5B3%5D=65777&vacancies%5B4%5D=1343434

Однако для удобства, в таких случаях можно передавать и структуру для обновления сущности.


Ответ

Ответ передаётся в виде массива, каждый элемент которого есть результат выполнения операции. В случае, когда результат операции не должен ничего возвращать, этот элемент массива будет равным null:

[null,null]
Методы API
Подборка резюме
Resource information
Url https://api.superjob.ru/2.0/hr/subscriptions/:id/
(пример по ссылке)
HTTP Method GET - получение, PUT — обновление записи,
DELETE — удаление записи
Аутентификация Требуется
Список нет
Входные параметры
Название Тип Обязательный Описание
:id int да ID подборки

Параметры обновления/создания подборки
Название Тип Описание
name string Название подборки резюме
status int Получать резюме на электронный адрес (установите параметр в 1 если нужно, и 0 если нет). При создании всегда 1. Сделать 0 можно только при обновлении
period int Время публикации резюме. Список возможных значений:
0 — за все время
1 — за последние 24 часа
3 — за последние 3 дня
7 — за последнюю неделю
14 — за последние 2 недели
30 — за последний 1 месяц
60 — за последние 2 месяца
keyword string Ключевое слово
keywords array Расширенный поиск ключевых слов. Каждый элемент массива есть массив со следующими параметрами:
Название Тип Can
be
empty
Описание
srwsintДаИскать в...
Список возможных значений:
  2 — месте проживания
  3 — ключевых навыках
  6 — образовании и курсах
  8 — названии организации
  50 — опыте работы
  60 — желаемой должности
  7 — тексте всего резюме
skwcstringДаКак искать.
Список возможных значений:
  and — все слова
  or — хотя бы одно слово
  particular — точную фразу
  nein — слова-исключения
keysstringНетКлючевое слово
exclude_words string Слова-исключения. Пробел - условие И, запятая - условие ИЛИ.
payment_from int Сумма оклада от
payment_to int Сумма оклада до
no_agreement int=1 Не показывать оклад «по договоренности» (установите параметр в 1).
t array Массив с ID городов
o array Массив с ID областей
c array Массив с ID стран
citizenship array Гражданство. Может принимать значения из массива с ID стран
metro array Массив с ID метро
catalogues int|commalist Список разделов каталога отраслей. Список значений можно узнать из метода catalogues, параметр key в любом объекте
place_of_work int Место работы. Возможные значения.
moveable int Готовность к переезду. Список возможных значений:
  1 — Живет в регионе или готов к переезду куда-либо
  2 — Живет в регионе или готов к переезду в него
  3 — Не живет в регионе, но готов к переезду в него
  4 — Живет в регионе
type_of_work int Тип занятости. Возможные значения.
id_institute int ID ВУЗа. Значения можно получить в методе /institutes.
age_from int Возраст от.
age_to int Возраст до.
gender int Пол. Возможные значения.
education int Образование. Возможные значения.
driving_licence array Наличие водительских прав. Содержит одно или несколько наименований категорий прав: ['A', 'B', 'C', 'D', 'E']
languages array of arrays Поиск по иностранным языкам. Состоит из массива, каждый элемент которого есть массив, который содержит следующие параметры:
language_idint Иностранный язык. Значения можно также получить в справочниках (language).
language_levelint Уровень владения иностранным языком. Возможные значения.
business_trip int Готовность к командировкам. Список возможных значений:
  1 — не готов
  2 — готов
Значения можно также получить в справочниках.
marital_status int Семейное положение. Список возможных значений:
  2 — состоит в браке
  3 — не состоит в браке
Значения можно также получить в справочниках.
children int Наличие детей. Список возможных значений:
  2 — нет
  3 — есть
Значения можно также получить в справочниках.
education_form int Форма обучения. Список возможных значений:
   10 — Дневная/Очная
   20 — Вечерняя
   30 — Очно-заочная
   40 — Заочная
   50 — Экстернат
   60 — Дистанционная
Значения можно также получить в справочниках ('education_form_resume').
experience_from int Опыт работы в месяцах. Нижняя граница интервала: например, от 12 месяцев
experience_to int Опыт работы в месяцах. Верхняя граница интервала: например, до 36 месяцев
portfolio int=1 Показывать только резюме с портфолио (установите параметр в 1).
has_photo int=1 Показывать только резюме с фотографией (установите параметр в 1).
Пример запроса

Обновление

PUT /2.0/hr/subscriptions/555/ HTTP/1.1
        Host: api.superjob.ru
        X-Api-App-Id: yourAppSecretKey
        Content-Type: application/x-www-form-urlencoded
        Authorization: Bearer h.000000000000001.example.token

        keywords%5B0%5D%5Bkeys%5D=PHP&keywords%5B0%5D%5Bskwc%5D=and&keywords%5B0%5D%5Bsrws%5D=7&exclude_words=&keywords%5B1%5D%5Bsrws%5D=50&keywords%5B1%5D%5Bskwc%5D=or&keywords%5B1%5D%5Bkeys%5D=php&period=60&place_of_work=1&t%5B%5D=4&moveable=1&m%5B%5D=29&m%5B%5D=54&m%5B%5D=44&m%5B%5D=120&m%5B%5D=11&m%5B%5D=140&m%5B%5D=197&m%5B%5D=555&m%5B%5D=74&m%5B%5D=161&m%5B%5D=25&m%5B%5D=42&m%5B%5D=96&m%5B%5D=28&m%5B%5D=6&m%5B%5D=78&m%5B%5D=7&m%5B%5D=12&m%5B%5D=46&m%5B%5D=34&m%5B%5D=196&m%5B%5D=31&m%5B%5D=98&m%5B%5D=10&m%5B%5D=30&m%5B%5D=13&m%5B%5D=165&m%5B%5D=45&m%5B%5D=141&m%5B%5D=93&m%5B%5D=119&m%5B%5D=142&m%5B%5D=43&m%5B%5D=199&m%5B%5D=94&m%5B%5D=33&m%5B%5D=32&m%5B%5D=85&m%5B%5D=200&m%5B%5D=95&m%5B%5D=138&m%5B%5D=139&m%5B%5D=8&m%5B%5D=151&catalogues=33%2C383%2C384&payment_from=1&payment_to=1000000&payment_no_agreement=1&type_of_work=6&old1=1&old2=99&marital_status=3&pol=2&children=2&education=2&eduform=10&id_institute=3561&institution=%D0%92%D0%B2%D0%B5%D0%B4%D0%B8%D1%82%D0%B5+%D0%BF%D0%B5%D1%80%D0%B2%D1%8B%D0%B5+%D0%B1%D1%83%D0%BA%D0%B2%D1%8B&languages%5B1%5D%5Blanguage_id%5D=1&languages%5B1%5D%5Blanguage_level%5D=5&languages%5B2%5D%5Blanguage_id%5D=2&languages%5B2%5D%5Blanguage_level%5D=3&DRL%5B%5D=B&DRL%5B%5D=C&DRL%5B%5D=D&DRL%5B%5D=E&business_trip=2&portfolio=1&has_photo=1&status=1&name=Subscription
                        

Удаление

DELETE /2.0/hr/subscriptions/555/ HTTP/1.1
        Host: api.superjob.ru
        X-Api-App-Id: yourAppSecretKey
        Content-Type: application/x-www-form-urlencoded
        Authorization: Bearer h.000000000000001.example.token

Создание

POST /2.0/hr/subscriptions/ HTTP/1.1
        Host: api.superjob.ru
        X-Api-App-Id: yourAppSecretKey
        Content-Type: application/x-www-form-urlencoded
        Authorization: Bearer h.000000000000001.example.token

        keywords%5B0%5D%5Bkeys%5D=PHP&keywords%5B0%5D%5Bskwc%5D=and&keywords%5B0%5D%5Bsrws%5D=7&exclude_words=&keywords%5B1%5D%5Bsrws%5D=50&keywords%5B1%5D%5Bskwc%5D=or&keywords%5B1%5D%5Bkeys%5D=php&period=60&place_of_work=1&t%5B%5D=4&moveable=1&m%5B%5D=29&m%5B%5D=54&m%5B%5D=44&m%5B%5D=120&m%5B%5D=11&m%5B%5D=140&m%5B%5D=197&m%5B%5D=555&m%5B%5D=74&m%5B%5D=161&m%5B%5D=25&m%5B%5D=42&m%5B%5D=96&m%5B%5D=28&m%5B%5D=6&m%5B%5D=78&m%5B%5D=7&m%5B%5D=12&m%5B%5D=46&m%5B%5D=34&m%5B%5D=196&m%5B%5D=31&m%5B%5D=98&m%5B%5D=10&m%5B%5D=30&m%5B%5D=13&m%5B%5D=165&m%5B%5D=45&m%5B%5D=141&m%5B%5D=93&m%5B%5D=119&m%5B%5D=142&m%5B%5D=43&m%5B%5D=199&m%5B%5D=94&m%5B%5D=33&m%5B%5D=32&m%5B%5D=85&m%5B%5D=200&m%5B%5D=95&m%5B%5D=138&m%5B%5D=139&m%5B%5D=8&m%5B%5D=151&catalogues=33%2C383%2C384&payment_from=1&payment_to=1000000&payment_no_agreement=1&type_of_work=6&old1=1&old2=99&marital_status=3&pol=2&children=2&education=2&eduform=10&id_institute=3561&institution=%D0%92%D0%B2%D0%B5%D0%B4%D0%B8%D1%82%D0%B5+%D0%BF%D0%B5%D1%80%D0%B2%D1%8B%D0%B5+%D0%B1%D1%83%D0%BA%D0%B2%D1%8B&languages%5B1%5D%5Blanguage_id%5D=1&languages%5B1%5D%5Blanguage_level%5D=5&languages%5B2%5D%5Blanguage_id%5D=2&languages%5B2%5D%5Blanguage_level%5D=3&DRL%5B%5D=B&DRL%5B%5D=C&DRL%5B%5D=D&DRL%5B%5D=E&business_trip=2&portfolio=1&has_photo=1&status=1&name=New+subscription
                        
Ответ

GET:

{
            "id":460219,
            "name":"The Name",
            "payment_from":1,
            "experience_to": 0,
            "experience_from": 72,
            "payment_to":1000000,
            "t":[
                {
                    "id":4,
                    "title":"Москва",
                    "declension":"в Москве",
                    "genitive":"Москвы"
                }
            ],
            "o":[],
            "c":[],
            "citizenship" : [],
            "type_of_work":{
                "id":6,
                "title":"Полный рабочий день"
            },
            "place_of_work":{
                "id":1,
                "title":"На территории работодателя"
            },
            "moveable":true,
            "business_trip":{
                "id":2,
                "title":"Готов"
            },
            "education":{
                "id":2,
                "title":"Высшее"
            },
            "children":{
                "id":2,
                "title":"Нет"
            },
            "portfolio":true,
            "has_photo":true,
            "period":{
                "id":60,
                "title":"2 месяца"
            },
            "catalogues":[
                {
                    "id":381,
                    "title":"Банки, инвестиции, лизинг",
                    "positions":[
                        {
                            "id":383,
                            "title":"Бэк-Офис"
                        },
                        {
                            "id":384,
                            "title":"Бюджетирование и планирование"
                        }
                    ]
                }
            ],
            "status":true,
            "age_from":1,
            "age_to":99,
            "driving_licence":[
                "B",
                "C",
                "D",
                "E"
            ],
            "no_agreement":true,
            "keywords":[
                {
                    "keys":"PHP",
                    "skwc":"and",
                    "srws":7
                },
                {
                    "keys":"python",
                    "skwc":"or",
                    "srws":50
                },
                {
                    "keys":"javascript",
                    "skwc":"particular",
                    "srws":60
                },
                {
                    "keys":"basic",
                    "skwc":"nein",
                    "srws":8
                }
            ],
            "town":{
                "id":4,
                "title":"Москва",
                "declension":"в Москве",
                "genitive":"Москвы"
            },
            "education_form":{
                "id":10,
                "title":"Дневная\/Очная"
            },
            "gender":{
                "id":2,
                "title":"Мужской"
            },
            "marital_status":{
                "id":3,
                "title":"Не состоит в браке"
            },
            "metro":[
                {
                    "id":6,
                    "title":"Комсомольская",
                    "id_metro_line":1
                },
                {
                    "id":555,
                    "title":"Деловой центр",
                    "id_metro_line":8
                }
            ],
            "institute":{
                "id":3561,
                "title":"Московский государственный университет им. М.В.Ломоносова"
            },
            "languages":[
                [
                    {
                        "id":1,
                        "title":"Английский"
                    },
                    {
                        "id":5,
                        "title":"Технический"
                    }
                ],
                [
                    {
                        "id":2,
                        "title":"Немецкий"
                    },
                    {
                        "id":3,
                        "title":"Базовый"
                    }
                ]
            ]
}

Параметры объекта

Название Тип Can
be
empty
Описание
id int Нет ID подборки
name string Нет Название подборки
status bool Нет Получать резюме на электронный адрес
town object Да Город. Совпадает с массивом t[] в случае наличия в нём только одного города. Содержит ID в ключе 'id' и название города в ключе 'title', а также склонение в ключе 'declension' и родительный падеж в ключе 'genitive'
keywords array Нет Ключевые слова. Каждый элемент массива есть массив со следующими параметрами:
Название Тип Can
be
empty
Описание
srwsintДаИскать в...
Список возможных значений:
  2 — месте проживания
  3 — ключевых навыках
  6 — образовании и курсах
  8 — названии организации
  50 — опыте работы
  60 — желаемой должности
  7 — тексте всего резюме
skwcstringДаКак искать.
Список возможных значений:
  and — все слова
  or — хотя бы одно слово
  particular — точную фразу
  nein — слова-исключения
keysstringНетКлючевое слово
period int Да Время публикации резюме. Список возможных значений:
0 — за все время
1 — за последние 24 часа
3 — за последние 3 дня
7 — за последнюю неделю
14 — за последние 2 недели
30 — за последний 1 месяц
60 — за последние 2 месяца
moveable bool Нет Показывать резюме соискателей из других городов, готовых переехать
t array Да Массив с ID городов. Каждый элемент массива есть объект, который содержит ID в ключе id, название города в ключе 'title'
o array Да Массив с ID областей. Каждый элемент массива есть объект, который содержит ID в ключе id, название области в ключе 'title'
c array Да Массив с ID стран. Каждый элемент массива есть объект, который содержит ID в ключе id, название страны в ключе 'title'
metro array Нет Список станций метро. Каждый элемент массива есть объект, который содержит ID в ключе id, название станции в ключе 'title' и ID ветки в 'id_metro_line'
age_from int Да Возраст от.
age_to int Да Возраст до.
payment_from int Да Уровень дохода "От"
payment_to int Да Уровень дохода "До"
no_agreement bool Нет Не показывать оклад по договоренности
experience_from int Нет Опыт работы в месяцах. Нижняя граница интервала: например, от 12 месяцев
experience_to int Нет Опыт работы в месяцах. Верхняя граница интервала: например, до 36 месяцев
type_of_work object Да Тип занятости. Объект содержит ID в ключе 'id' и название типа занятости в ключе 'title'.
Список возможных значений:
  0 — не имеет значения
  6 — полный день
  10 — неполный день
  12 — сменный график
  13 — частичная занятость
  7 — временная работа
  9 — вахтовым методом
Значения можно также получить в справочниках.
place_of_work object Да Место работы. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  0 — не имеет значения
  1 — на территории работодателя
  2 — на дому
  3 — разъездного характера
Значения можно также получить в справочниках.
education object Да Образование. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  2 — Высшее
  3 — Неполное высшее
  4 — Среднее специальное
  5 — Среднее
  6 — Учащийся школы
  7 — Бакалавр
  8 — Магистр
  9 — Кандидат наук
  10 — Доктор наук
Значения можно также получить в справочниках.
education_form int Да Форма обучения. Список возможных значений:
   10 — Дневная/Очная
   20 — Вечерняя
   30 — Очно-заочная
   40 — Заочная
   50 — Экстернат
   60 — Дистанционная
Значения можно также получить в справочниках ('education_form_resume').
institute objectДа Учебное заведение. Объект содержит ID в ключе 'id' и название в ключе 'title'. Значения можно получить в методе /institutes.
maritalstatus object Да Семейное положение. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  2 — состоит в браке
  3 — не состоит в браке
Значения можно также получить в справочниках.
children object Да Наличие детей. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  2 — нет
  3 — есть
Значения можно также получить в справочниках.
business_trip object Да Готовность к командировкам. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  1 — не готов
  2 — готов
Значения можно также получить в справочниках.
languages array Да Наименование и уровень владения иностранными языками. Каждая пара язык\уровень – это отдельный массив.
[[{"id":1,"title": "Английский"},{"id":9,"title": "Cвободное владение"}]]

Первый элемент массива Наименование иностранного языка: объект, который содержит ID в ключе 'id' и название языка в ключе 'title'.
Второй элемент массива Уровень владения языком: объект, который содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  3 — базовый
  5 — технический
  7 — разговорный
  9 — свободное владею
Значения можно также получить в справочниках.
driving_licence array Да Наличие водительских прав. Содержит одно или несколько наименований категорий прав: ['A', 'B', 'C', 'D', 'E']
catalogues array Да Список категорий и отраслей резюме. Каждый элемент массива есть объект (отрасль), который содержит ID в ключе 'id' и название каталога в ключе 'title'. Кроме того, есть массив 'positions', который содержит выбранные категории каталога. В массиве находится точно такой же по структуре объект - категория.
gender object Да Пол. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  2 — мужской
  3 — женский
Значения можно также получить в справочниках ('gender_resume').
has_photo bool Нет Есть ли фотография
portfolio bool Нет Есть ли портфолио
citizenship array Да Гражданство. Массив с ID стран. Каждый элемент массива есть объект, который содержит ID в ключе id, название страны в ключе 'title'

POST:

Код 201. Содержимое см. здесь.

PUT:

Код 200. Содержимое см. здесь.

DELETE:

Код 204 без контента

Подборки резюме
Resource information
Url https://api.superjob.ru/2.0/hr/subscriptions/
HTTP Method GET - вывод списка подборок, POST - создание подборки.
Аутентификация Требуется
Список GET - да
POST - нет
Параметры

Параметры создания подборки см. здесь.

Ответ

GET:

{
        "objects":[
            {
                "id": 25746005,
                "name": "Подборка без названия",
                // ...
            }
        ],
        "total": 29,
        "more":true
}

Параметры объекта в массиве objects см. здесь


POST:

Код 201. Содержимое ответа см. здесь.

Описание параметров ответа см. здесь.

Ошибки выводятся в стандартном формате.

Покупка контактов резюме
Resource information
Url https://api.superjob.ru/2.0/hr/resumes/:id_resume/buy/
HTTP Method POST
Аутентификация Требуется
Список нет
Входные параметры
Название Тип Обязательный Описание
:id_resume int да ID резюме
Пример запроса
POST /2.0/hr/resumes/555/buy/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    
Ответ

Успешная покупка:

{
        "status": true,
        "resume":{ тут будет резюме с контактами},
        "error":null
}

Ошибка:

{
        "status":false,
        "resume" null,
        "error":{
            "code":403,
            "message":"Нельзя купить резюме",
            "data":{
                "error":"insufficient_rights"
            }
        }
}
Параметры ответа
Название Тип Can
be
empty
Описание
status bool Нет Статус покупки резюме: true - резюме куплено, false - ошибка покупки резюме
resume int Да Резюме
error object Да Ошибка при неудачной покупке резюме. В ключе data содержит метку о причине неудачи:
                                access_denied - доступ запрещён
                                insufficient_rights - недостаточно прав для покупки резюме
                                tariff_mismatch - купить резюме не позволяет тариф
                                not_enough_money - не хватает денег на балансе
                                need_to_buy_first - нельзя купить резюме за деньги, если покупка вызвана из другого действия
                                resume_not_published - резюме не опубликовано
                            
Получение контактов резюме
Resource information
Url https://api.superjob.ru/2.0/hr/resumes/:id_resume/open/
HTTP Method GET
Аутентификация Требуется
Список Нет
Входные параметры
Название Тип Обязательный Описание
:id_resume int да ID резюме
Пример запроса
GET /2.0/hr/resumes/555/open/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Authorization: Bearer h.000000000000001.example.token
Ответ

Успешное получение контактных данных

{
    "status": true,
    "resume": {тут будет резюме с контактами},
    "error": null
}

Ошибка

{
    "status": false,
    "resume": null,
    "error": {
        "code": 403,
        "message": "сообщение об ошибке"
    }
}
Параметры ответа
Название Тип Can
be
empty
Описание
status bool Нет Статус получения контактов резюме: true - контакты получны, false - ошибка получения контактов
resume object Да Резюме
error object Да Ошибка при неудачном получении контактов резюме. В ключе code содержит код ошибки:
403 - доступ запрещён
429 - превышен лимит попыток получения контактов резюме


Отправить письмо соискателю: шаблоны

Для отправки письма соискателю используются шаблоны: как стандартные, так и созданные вручную.

Resource information
Url https://api.superjob.ru/2.0/hr/resumes/:id_resume/mail_data/
HTTP Method GET
Аутентификация Требуется
Список нет
Входные параметры
Название Тип Обязательный Описание
:id_resume int да ID резюме
Пример запроса
GET https://api.superjob.ru/2.0/hr/resumes/555/mail_data/
Ответ
{
        "send_sms":true,
        "templates":[
            {
                "id":"0",
                "name":"Ввести тему и текст письма самостоятельно",
                "body":" С уважением, Иванова Светлана Александровна, +7 (495) 000-00-00, Вектор",
                "greeting":"Здравствуйте, Василий Андреевич!",
                "subject":""
            },
            {
                "id":"3",
                "name":"Перезвоните нам, пожалуйста",
                "body":"В настоящее время в нашей организации открыта вакансия.",
                "greeting":"Здравствуйте, Василий Андреевич!",
                "subject":"Перезвоните нам, пожалуйста"
            }
        ],
        "total": 2,
        "more": false
}
Параметры ответа
Название Тип Описание
total int Количество шаблонов
more bool Есть ли ещё шаблоны? (всегда false)
send_sms bool Можно ли отправлять SMS соискателю?
templates array Список шаблонов. Содержит следующие параметры:
Название Тип Описание
id int ID шаблона. Используется при отправке письма по шаблону
name string Название шаблона
body string Текст сообщения шаблона
greeting string Пригласительное сообщение
subject string Заголовок шаблона
Отправить резюме на электронный ящик
Resource information
Url https://api.superjob.ru/2.0/hr/resumes/:id_resume/mail_to/
HTTP Method POST
Аутентификация Требуется
Список нет
Входные параметры
Название Тип Обязательный Описание
:id_resume int да ID резюме
email_to string да E-mail получателя в виде name@domain.com
email_from string нет E-mail отправителя в виде name@domain.com. Если не задан, берётся из профиля текущего пользователя
name_from string нет Имя отправителя. Если не задано, берётся из профиля текущего пользователя
mail_body string нет Сообщение получателю
Пример запроса
POST /2.0/hr/resumes/555/mail_to/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    email_to=stranger%40test.ru&mail_body=Test+of+mail&email_from=test%40mail.ru&name_from=%D0%9F%D0%B0%D0%BF%D0%B8%D0%BA%D1%8F%D0%BD+%D0%90%D1%80%D0%B0%D0%BC
    
Ответ
{result: true}
Ошибки
{
        "error":{
            "code":422,
            "message":"Validation error",
            "errors":[{
                "email_to":["Неправильное значение адреса электронной почты"]
            }]
        }
}
Отправить письмо соискателю
Resource information
Url https://api.superjob.ru/2.0/hr/resumes/:id_resume/send_mail/
HTTP Method POST
Аутентификация Требуется
Список нет
Входные параметры
Название Тип Обязательный Описание
:id_resume int да ID резюме
id_template int да ID шаблона. Список шаблонов можно получить здесь.
mail_subject string нет Заголовок письма
mail_body string нет Сообщение соискателю
send_sms int=1|bool нет Отправить адресату SMS-уведомление после отправки письма. Узнать, есть ли такая возможность, можно здесь.
Пример запроса
POST /2.0/hr/resumes/555/send_mail/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    id_template=0&mail_subject=%D0%A2%D0%B5%D1%81%D1%82%D0%B8%D1%80%D1%83%D0%B5%D0%BC+%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D1%8F&mail_body=%D0%A2%D0%B5%D1%81%D1%82+%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B8+%D0%BF%D0%B8%D1%81%D1%8C%D0%BC%D0%B0
Ответ
{result: true}
Ошибки
{
        "error":{
            "code":422,
            "message":"Validation error",
            "errors":[{
                "id_template":["Неправильное значение шаблона"]
            }]
        }
}
Приглашение соискателя: шаблоны

Для отправки приглашения соискателю используются шаблоны: как стандартные, так и созданные вручную.

Resource information
Url https://api.superjob.ru/2.0/hr/resumes/:id_resume/invitation_data/
HTTP Method GET
Аутентификация Требуется
Список нет
Входные параметры
Название Тип Обязательный Описание
:id_resume int да ID резюме
Пример запроса
GET https://api.superjob.ru/2.0/hr/resumes/555/invitation_data/
Ответ
{
        "send_sms": true,
        "templates":[
            {
                "id":"1",
                "name":"Приглашение на собеседование",
                "body":"В настоящее время в нашей организации открыта вакансия. Ваша Кандидатура нас заинтересовала, и мы хотели бы пригласить Вас на собеседование. Мы ждем Вас у нас в офисе для прохождения интервью. Пожалуйста, предварительно перезвоните нам в рабочее время, чтобы договориться о времени встречи. В случае если наша вакансия Вас не заинтересовала, пожалуйста, сообщите нам об этом. С уважением, Папикян Арам, +7 (495) 790-72-77, Триумвират",
                "greeting":"Здравствуйте, Имя!",
                "subject":"Приглашение на собеседование"
            }
        ],
        "total": 1,
        "more": false
}
Параметры ответа
Название Тип Описание
total int Количество шаблонов
more bool Есть ли ещё шаблоны? (всегда false)
send_sms bool Можно ли отправлять SMS соискателю?
templates array Список шаблонов. Содержит следующие параметры:
Название Тип Описание
id int ID шаблона. Используется при отправке приглашения по шаблону
name string Название шаблона
body string Текст сообщения шаблона
greeting string Пригласительное сообщение
subject string Заголовок шаблона
Пригласить соискателя
Resource information
Url https://api.superjob.ru/2.0/hr/resumes/:id_resume/invite/
HTTP Method POST
Аутентификация Требуется
Список нет
Входные параметры
Название Тип Обязательный Описание
:id_resume int да ID резюме
id_template int да ID шаблона. Список шаблонов можно получить здесь.
mail_subject string нет Заголовок приглашения
mail_body string нет Сообщение соискателю
send_sms int=1|bool нет Отправить адресату SMS-уведомление после отправки письма. Узнать, есть ли такая возможность, можно здесь.
Пример запроса
POST /2.0/hr/resumes/555/invite/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    id_template=1&mail_subject=%D0%9F%D1%80%D0%B8%D0%B3%D0%BB%D0%B0%D1%88%D0%B5%D0%BD%D0%B8%D0%B5+%D0%BD%D0%B0+%D1%81%D0%BE%D0%B1%D0%B5%D1%81%D0%B5%D0%B4%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5&mail_body=%0D%0A%D0%9C%D1%8B+%D0%B6%D0%B4%D0%B5%D0%BC+%D0%92%D0%B0%D1%81+%D1%83+%D0%BD%D0%B0%D1%81+%D0%B2+%D0%BE%D1%84%D0%B8%D1%81%D0%B5+%D0%B4%D0%BB%D1%8F+%D0%BF%D1%80%D0%BE%D1%85%D0%BE%D0%B6%D0%B4%D0%B5%D0%BD%D0%B8%D1%8F+%D0%B8%D0%BD%D1%82%D0%B5%D1%80%D0%B2%D1%8C%D1%8E.%0D%0
Ответ
{result: true}
Ошибки
{
        "error":{
                    "code":422,
                    "message":"Validation error",
                    "errors":[{
                        "id_template":["Неправильное значение шаблона"]
                    }]
        }
}
Отклонение соискателя: шаблоны

Для отказа соискателю могут использоваться шаблоны: как стандартные, так и созданные вручную.

Resource information
Url https://api.superjob.ru/2.0/hr/resumes/:id_resume/rejection_data/
HTTP Method GET
Аутентификация Требуется
Список нет
Входные параметры
Название Тип Обязательный Описание
:id_resume int да ID резюме
Пример запроса
GET https://api.superjob.ru/2.0/hr/resumes/555/rejection_data/
Ответ
{
        "templates":[
            {
                "id":"2",
                "name":"Ваша Кандидатура рассмотрена и отклонена",
                "body":"Большое спасибо за Ваш интерес к нашей вакансии. К сожалению, в настоящий момент мы не готовы сделать Вам предложение. Мы внимательно ознакомились с Вашей Кандидатурой, и, возможно, рассмотрим ее, когда у нас возникнет такая потребность. Надеемся, что в самое ближайшее время Вы сможете себя реализовать на работе в другой компании. С уважением, xxx",
                "greeting":"Здравствуйте, Иван Игоревич!",
                "subject":"Ваша Кандидатура рассмотрена и отклонена"
            },
            {
                "id":"4",
                "name":"Ваша Кандидатура отклонена после собеседования",
                "body":"Большое спасибо за время, уделенное собеседованию в нашей компании. К сожалению, в настоящий момент мы не готовы сделать Вам предложение по работе. Надеемся, что в самое ближайшее время Вы сможете себя реализовать на работе в другой организации. С уважением, Папикян Арам, , Триумвират",
                "greeting":"Здравствуйте, Иван Игоревич!",
                "subject":"Ваша Кандидатура отклонена после собеседования"
            },
            {
                "id":"5",
                "name":"Уведомление о закрытии вакансии",
                "body":"В настоящее время вакансия закрыта, и прием резюме к рассмотрению прекращен. Благодарим Вас за интерес к нашей вакансии. Желаем успехов в дальнейшем поиске работы! С уважением, xxx",
                "greeting":"Здравствуйте, Иван Игоревич!",
                "subject":"Уведомление о закрытии вакансии"
            }
        ],
        "total":3,
        "more":false
}
Параметры ответа
Название Тип Описание
total int Количество шаблонов
more bool Есть ли ещё шаблоны? (всегда false)
templates array Список шаблонов. Содержит следующие параметры:
Название Тип Описание
id int ID шаблона. Используется при отправке отказа по шаблону
name string Название шаблона
body string Текст сообщения шаблона
greeting string Пригласительное сообщение
subject string Заголовок шаблона
Отказать соискателю
Resource information
Url https://api.superjob.ru/2.0/hr/resumes/:id_resume/reject/
HTTP Method POST
Аутентификация Требуется
Список нет
Входные параметры
Название Тип Обязательный Описание
:id_resume int да ID резюме
id_template int нет ID шаблона. Список шаблонов можно получить здесь. Если не передавать ID шаблона (и все остальные параметры), соискателю будет оказано без письма
mail_subject string нет Заголовок приглашения
mail_body string нет Сообщение соискателю
Пример запроса
POST /2.0/hr/resumes/555/reject/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    
Ответ
{result: true}
Ошибки
{
        "error":{
            "code":422,
            "message":"Ошибки валидации",
            "errors":[{
                "id_template":["Неправильное значение шаблона"]
            }]
        }
}
Переложить резюме в папку "Рассмотреть позже"
Resource information
Url https://api.superjob.ru/2.0/hr/resumes/:id_resume/later/
HTTP Method POST
Аутентификация Требуется
Список нет
Входные параметры
Название Тип Обязательный Описание
:id_resume int да ID резюме
id_folder int|string нет ID папки. По умолчанию равна considered (системная папка "На рассмотрении")
Пример запроса
POST /2.0/hr/resumes/555/later/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    
Ответ
{result: true}
Ошибки
{
        "error":{
            "code":422,
            "message":"Папка передана неверно",
            "errors":[]
        }
}
Переложить резюме в произвольную папку в откликах
Resource information
Url https://api.superjob.ru/2.0/hr/resumes/:id_resume/move/
HTTP Method POST
Аутентификация Требуется
Список нет
Входные параметры
Название Тип Обязательный Описание
:id_resume int да ID резюме
id_folder int|string да ID папки. Может принимать 4 значения системных папок:
inbox - Входящие
invited - Приглашённые
considered - На рассмотрении
refused - Отклонённые
Кроме того, id_folder может принимать числовое значение - id пользовательской папки
Пример запроса
POST /2.0/hr/resumes/555/move/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    id_folder=invited
Ответ
{result: true}
Ошибки
{
        "error":{
            "code":422,
            "message":"Папка передана неверно",
            "errors":[]
        }
}
Список комментариев к резюме

Список так же содержит комментарии к другим резюме пользователя

Resource information
Url https://api.superjob.ru/2.0/hr/resumes/:id_resume/comments/
HTTP Method GET - вывод списка комментариев, POST - создание комментария.
Аутентификация Требуется
Список GET - да
POST - нет
Параметры
Название Тип Описание
:id_resume int ID комментируемого резюме. Резюме должно существовать
comment string Текст комментария
Пример запроса

Вставка:

POST /2.0/hr/resumes/555/comments/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    comment=someinformation

Поиск:

GET https://api.superjob.ru/2.0/hr/resumes/555/comments/
Ответ

GET:

{
        "objects":[
            {
                "id":52113687,
                "id_resume": 555,
                "text":"Хорошее резюме",
                "author":null,
                "date":1422539546
            },
            {
                "id":52113684,
                "id_resume": 1000000,
                "text":"Нужно брать",
                "author": "Иришка Иришкова",
                "date":1422537343
            },

        ],
        "total":2
        "more":false
}

Параметры каждого элемента из массива objects см. здесь


POST:

201 со следующим содержимым:

{
        "id":52113687,
        "text":"Хорошее резюме",
        "author":null,
        "date":1422539546
}

Ошибки выводятся в стандартном формате.

Комментарий к резюме
Resource information
Url https://api.superjob.ru/2.0/hr/resumes/comments/:id_comment/
HTTP Method DELETE - удаление комментария
Аутентификация Требуется
Список нет
Параметры
Название Тип Описание
:id_comment int ID комментария. Он должен принадлежать текущему пользователю
Пример запроса

Удаление:

DELETE https://api.superjob.ru/2.0/hr/resumes/comments/1445/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token
Ответ

DELETE:

Пустой ответ с кодом 204.

Полученные резюме
Resource information
Url https://api.superjob.ru/2.0/resumes/received/
HTTP Method GET
Аутентификация Требуется
Список да
Входные параметры
Название Тип Описание
keywords string Ключевые слова
id_vac int ID вакансии
order_by string Сортировка полученных резюме. Может принимать следующие значения:
date_last_eventсортировка по дате
paymentсортировка по зарплате
ageсортировка по возрасту
educationсортировка по образованию
date_event_from int(unixtime) Дата получения резюме от
date_event_to int(unixtime) Дата получения резюме до
payment_from int Уровень дохода "От"
payment_to int Уровень дохода "До"
payment_no_agreement int Не показывать резюме с уровнем дохода "По договоренности" (установить в 1)
age_from int Возраст "От"
age_to int Возраст "До"
type int Способ получения резюме. Может принимать значения:

0 - все
10 - присланные соискателем
30 - полученные по подписке
40 - найденные самостоятельно
20 - полученные от коллеги
50 - скопированные от коллеги
types array of int Способ получения резюме. Alias для параметра type в виде массива. Если задан, имеет более высокий приоритет, чем type. Каждый элемент массива может принимать значения:

10 - присланные соискателем
30 - полученные по подписке
40 - найденные самостоятельно
20 - полученные от коллеги
50 - скопированные от коллеги
status int Статус полученного резюме. Может принимать значения:

0 - Входящие резюме
10 - Приглашённые резюме
20 - Резюме на рассмотрении
30 - Отклонённые резюме
type_of_work int Тип занятости. Значения можно посмотреть в справочниках
only_new_received int=1 Показывать только новые резюме (установите параметр равным 1).

По умолчанию возвращаются резюме за последние 3 месяца. Этот период можно изменить, соответственно, указав date_event_from и date_event_to

Пример запроса
GET https://api.superjob.ru/2.0/resumes/received/?keywords=php&order_by=age&date_event_from=1366536351&date_event_to=1429608351&payment_from=10000&payment_to=50000&payment_no_agreement=1&age_from=20&age_to=60&type=10&type_of_work=6&only_new_received=1
Ответ
{
        "objects":[
            {
                "resume":{
                    // ...
                },
                "is_new":"boolean. true - если пользователь еще не просмотрел отклик, false - в противном случае",
                "events":[
                    {
                        "id_resume":10000000000,
                        "id_vac":2222222222,
                        "type":80,
                        "date_event":1392232237,
                        "text":"Отклонено",
                        "date":"12 февраля",
                        "description":"на вакансию «Монтировщик»",
                        "type_title":"Найдено 12 февраля самостоятельно на вакансию «Монтировщик»"
                    }
                ]
            }, // ....
        ],
        "total":3,
        "more":false
    }
    

Описание объекта resume см. здесь.

Параметры массива events:

Название Тип Can
be
empty
Описание
id_resume int да ID резюме
id_vac int да* ID вакансии (* - может быть равно нулю)
type int да Тип события.
10 — прислано Соискателем
20 — мне скопировали от другого пользователя
30 — прислано по подписке
40 — найдено самостоятельно
50 — скопировал от другого пользователя
60 — пригласил
70 — перенёс на рассмотрение
80 — отклонил
90 — оправлено письмо (действие)
100 — отправлено на email
110 — перенесно в другую папку
120 — добавлено пользователю (от меня)
date_event int (unixtime) Да Время события
text string Нет Краткое описание события
date string Нет Текстовое описание даты возникновения события
description string Нет Описание события
type_title string Нет Полное описание события
Полученные резюме всех пользователей клиента
Resource information
Url https://api.superjob.ru/2.0/resumes/received-by-client/
HTTP Method GET
Аутентификация Требуется
Список да
Входные параметры
Название Тип Описание
keywords string Ключевые слова
order_by string Сортировка полученных резюме. Может принимать следующие значения:
date_last_eventсортировка по дате
paymentсортировка по зарплате
ageсортировка по возрасту
educationсортировка по образованию
date_event_from int(unixtime) Дата получения резюме от
date_event_to int(unixtime) Дата получения резюме до
payment_from int Уровень дохода "От"
payment_to int Уровень дохода "До"
payment_no_agreement int Не показывать резюме с уровнем дохода "По договоренности" (установить в 1)
age_from int Возраст "От"
age_to int Возраст "До"
type int Способ получения резюме. Может принимать значения:

0 - все
10 - присланные соискателем
30 - полученные по подписке
40 - найденные самостоятельно
20 - полученные от коллеги
50 - скопированные от коллеги
types array of int Способ получения резюме. Alias для параметра type в виде массива. Если задан, имеет более высокий приоритет, чем type. Каждый элемент массива может принимать значения:

10 - присланные соискателем
30 - полученные по подписке
40 - найденные самостоятельно
20 - полученные от коллеги
50 - скопированные от коллеги
status int Статус полученного резюме. Может принимать значения:

0 - Входящие резюме
10 - Приглашённые резюме
20 - Резюме на рассмотрении
30 - Отклонённые резюме
type_of_work int Тип занятости. Значения можно посмотреть в справочниках
only_new_received int=1 Показывать только новые резюме (установите параметр равным 1).

По умолчанию возвращаются резюме за последние 3 месяца. Этот период можно изменить, соответственно, указав date_event_from и date_event_to

Требуются права управления пользователями

Пример запроса
GET https://api.superjob.ru/2.0/resumes/received-by-client/?keywords=php&order_by=age&date_event_from=1366536351&date_event_to=1429608351&payment_from=10000&payment_to=50000&payment_no_agreement=1&age_from=20&age_to=60&type=10&type_of_work=6&only_new_received=1
Ответ
{
    "objects":[
        {
            "resume":{
                // ...
            },
            "is_new":"boolean. true - если пользователь еще не просмотрел отклик, false - в противном случае",
            "events":[
                {
                    "id_resume":10000000000,
                    "id_vac":2222222222,
                    "type":80,
                    "date_event":1392232237,
                    "text":"Отклонено",
                    "date":"12 февраля",
                    "description":"на вакансию «Монтировщик»",
                    "type_title":"Найдено 12 февраля самостоятельно на вакансию «Монтировщик»"
                }
            ]
        }, // ....
    ],
    "total":3,
    "more":false
}

Описание объекта resume см. здесь.

Параметры массива events:

Название Тип Can
be
empty
Описание
id_resume int да ID резюме
id_vac int да* ID вакансии (* - может быть равно нулю)
type int да Тип события.
10 — прислано Соискателем
20 — мне скопировали от другого пользователя
30 — прислано по подписке
40 — найдено самостоятельно
50 — скопировал от другого пользователя
60 — пригласил
70 — перенёс на рассмотрение
80 — отклонил
90 — оправлено письмо (действие)
100 — отправлено на email
110 — перенесно в другую папку
120 — добавлено пользователю (от меня)
date_event int (unixtime) Да Время события
text string Нет Краткое описание события
date string Нет Текстовое описание даты возникновения события
description string Нет Описание события
type_title string Нет Полное описание события
Счётчик новых полученных резюме
Resource information
Url https://api.superjob.ru/2.0/resumes/received/counter
HTTP Method GET
Аутентификация Требуется
Список нет
Пример запроса
GET https://api.superjob.ru/2.0/resumes/received/counter/
Ответ
{"total": 6}
Отклики на вакансию
Resource information
Url https://api.superjob.ru/2.0/resumes/received/:id_vac/
HTTP Method GET
Аутентификация Требуется
Список да
Входные параметры
Название Тип Обязательный Описание
:id_vac int да ID вакансии

Остальные входные параметры, аналогичны методу /resumes/received/.

Пример запроса
GET https://api.superjob.ru/2.0/resumes/received/555/?only_new_received=1
Ответ

Структура ответа совпадает с /resumes/received/, за исключением того, что в него добавлено поле cover_letter (сопроводительное письмо).

{
        "objects":[
            {
                "resume":{
                    // ...
                },
                "cover_letter": "Сопроводительное письмо",
                "events":[
                    {
                        // .....
                    }
                ]
            }, // ....
        ],
        "total":3,
        "more":false
    }
    
Восстановление пароля
Resource information
Url https://api.superjob.ru/2.0/hr/forgot_password/
HTTP Method POST
Список нет
Входные параметры
Название Тип Обязательный Описание
login string да Логин (или email или телефон) пользователя
Пример запроса
POST /2.0/hr/forgot_password/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded

    login=yourlogin
{"result": "Пароль выслан на +7 xxx xxx-88-xx"}

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

Текущий пользователь
Resource information
Url https://api.superjob.ru/2.0/user/current/
HTTP Method GET
Аутентификация Требуется
Список нет
Пример запроса
GET https://api.superjob.ru/2.0/user/current/
Ответ

    {
        "tariffs":[
            {
                "title":"Демо-доступ «Все города России»",
                "display_name":"Демо",
                "type":"test",
                "dates":[
                    {
                        "unixtime_date_from":1424811600,
                        "unixtime_date_to":null,
                        "effective_days":0
                    }
                ],
                "is_unlimited":false,
                "is_demo":true,
                "resume_count":5,
                "vacancy_price":0,
                "resume_price":0,
                "days_left":-1,
                "is_turbo":false,
                "vacancy_count":1,
                "is_basic":false
            }
        ],
        "id":1,
        "email":"example@example.com",
        "name":"Вектор",
        "date_reg":1055925317,
        "date_lastlogin":1408445824,
        "hr":true,
        "id_client":1,
        "login":"mylogin",
        "id_town":4,
        "town": {
        "id": 4,
        "title": "Москва",
        "declension": "в Москве",
        "genitive": "Москвы"
        },
        "company_opf":"ООО",
        "company_name":"Вектор",
        "company_description":"Создание и поддержка корпоративных продуктов в сети Интернет",
        "firstname":"Еллий",
        "lastname":"Ivanov",
        "middlename":"Иванович",
        "position":"Заместитель директора по разработке",
        "subscribe_news":1,
        "phones":[
            "7(495)790-72-77"
        ],
        "user_rights":[
            {
                "type":"manage_users",
                "title":"Управление пользователями"
            },
            {
                "type":"manage_bills",
                "title":"Управление оплатами"
            }
        ],
        "receive_recommendation":true,
        "received_resume_notification":true,
        "photo":"https://public.superjob.ru/images/clients_logos.ru/1.jpg",
        "balance": 9600
    }
    

Параметры объекта

Название Тип Can
be
empty
Описание
id int Нет ID пользователя
email string Нет E-mail пользователя
name string Нет Имя компании-работодателя
date_reg int (unixtime) Нет Дата регистрации пользователя
date_lastlogin int (unixtime) Нет Дата последнего логина пользователя
hr bool Нет Является ли текущий пользователь работодателем
id_client int Нет ID клиента-работодателя, к которому принадлежит текущий пользователь
login string Да Логин пользователя
id_town int Нет ID города
town object Нет Объект города. Содержит ключи id и title
company_opf string Нет Правовая форма организации
company_name string Нет Имя компании-работодателя
company_description string Нет Описание компании-работодателя
firstname string Нет Имя пользователя
lastname string Нет Фамилия пользователя
middlename string Да Отчество пользователя
position string Нет Должность пользователя
phones array Нет Список номеров телефонов. Должен присутствовать хотя бы один. Каждый элемент - строка с номером телефона.
user_rights array Нет Список прав пользователя
view_vacs Просмотр вакансий других пользователей
master Управление вакансиями других пользователей
manage_users Управление пользователями
manage_bills Управление оплатами
create_vacs Создание и редактирование вакансий
buy_resumes Работа с базой резюме
edit_companyinfo Редактирование информации о компании
create_traineeships Размещение стажировки
create_events_for_students Размещение события для студентов
access_denied Доступ пользователю отключен
receive_recommendation bool Нет Получать на почту рекомендации по увеличению количества резюме
received_resume_notification bool Нет Сразу получать на почту уведомление об отклике соискателя на вакансию, иначе - раз в сутки
subscribe_news bool Нет Получать на почту рассылку новостей Superjob
photo string Да Ссылка на логотип компании
balance int Да Баланс счета компании
tariffs array Нет Массив с тарифами текущего работодателя. Каждый элемент массива есть объект, содержащий:
Название Тип Can
be
empty
Описание
titlestringнетПолное наименование тарифа
display_namestringнетКраткое наименование тарифа
typestringнетТип тарифа. Может принимать следующие значения:
unlim — Безлимит
basic — Базовый
test — Демо
benefic — Социальный
check —Демо
turbo —Турбо-вакансия
datesarrayдаСвойства тарифа, связанные со временем (обычно касаются безлимитных тарифов):
Название Тип Can
be
empty
Описание
unixtime_date_fromintдаДата начала срока действия тарифа
unixtime_date_tointдаДата окончания срока действия тарифа
effective_daysintнетКоличество дней до окончания срока действия тарифа
is_unlimitedboolнетЯвляется ли тариф безлимитным
is_demoboolнетВключён ли демо-доступ
resume_countintнетКоличество доступных резюме для покупки (если применимо к тарифу)
resume_priceintнетСтоимость покупки одного резюме (если применимо к тарифу)
vacancy_priceintнетСтоимость покупки одной вакансии (если применимо к тарифу)
days_leftintнетСрок окончания действия тарифа в днях (если применимо к тарифу, если нет - равно -1)
is_turboboolнетВключён ли турбо-тариф
vacancy_countintнетКоличество турбо-вакансий (если включён турбо-тариф)
is_basicboolнетВключён ли базовый тариф
Информация о пользователе
Resource information
Url https://api.superjob.ru/2.0/hr/user/:id/
HTTP Method GET
Аутентификация Требуется. Запрос подобного плана может совершать
только пользователь компании,
обладающий соответствующими правами (manage_users)
Список нет
Входные параметры
Название Тип Обязательный Описание
:id int да ID пользователя компании. Значения можно получить в методе /user/list.
Пример запроса
GET https://api.superjob.ru/2.0/hr/user/555/
Ответ

Ответ и параметры объекта ответа идентичны методу /user/current.

Пользователь. REST
Resource information
Url https://api.superjob.ru/2.0/hr/user/, - создание;
https://api.superjob.ru/2.0/hr/user/:id/ - обновление и удаление
(пример по ссылке)
HTTP Method POST - создание пользователя.
PUT и DELETE для обновления
и удаления пользователя соответственно
Аутентификация Требуется. Запрос подобного плана может совершать
только пользователь компании,
обладающий соответствующими правами (manage_users)
Список нет
Входные параметры
Название Тип Обязательный Описание
:id int да - для обновления и удаления.
Для создания - не нужен
ID пользователя
email string Да E-mail пользователя. На него придёт письмо с регистрационными данными пользователя.
login string Да Логин пользователя.
password string Нет Пароль пользователя. Если не передан - генерируется автоматически.
id_town int Да ID города
company_opf string Да Правовая форма организации
company_name string Да Имя компании-работодателя
company_description string Да Описание компании-работодателя
firstname string Да Имя пользователя
lastname string Да Фамилия пользователя
middlename string Нет Отчество пользователя
position string Да Должность пользователя
phones array Да Список номеров телефонов. Должен присутствовать хотя бы один. Каждый элемент - массив со следующей структурой:
Название Тип Обязательный Описание
country_codenumericдаКод страны
city_codenumericдаКод города
numberstringдаНомер телефона в произвольном формате
additionalstringнетДобавочный номер.
user_rights array Да Список прав пользователя. Каждый элемент массива может быть строкой из следующего перечня значений:
view_vacs Просмотр вакансий других пользователей
master Управление вакансиями других пользователей
manage_users Управление пользователями
manage_bills Управление оплатами
create_vacs Создание и редактирование вакансий
buy_resumes Работа с базой резюме
edit_companyinfo Редактирование информации о компании
create_traineeships Размещение стажировки
create_events_for_students Размещение события для студентов
access_denied Доступ пользователю отключен.
receive_recommendation bool Нет Получать на почту рекомендации по увеличению количества резюме
received_resume_notification bool Нет Сразу получать на почту уведомление об отклике соискателя на вакансию, иначе - по будням два раза в сутки
subscribe_news bool Нет Получать на почту рассылку новостей Superjob
Пример запроса

Создание

POST /2.0/hr/user/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    login=loginexample&password=ReallyHardPasswordExample&lastname=Ivanov&firstname=Ivan&middlename=Ivanovitch&birthday=1&birthmonth=2&birthyear=1984&position=Engineer&phones%5B0%5D%5Bcountry_code%5D=7&phones%5B0%5D%5Bcity_code%5D=498&phones%5B0%5D%5Bnumber%5D=999-88-88&phones%5B0%5D%5Badditional%5D=2054&phones%5B1%5D%5Bcountry_code%5D=3&phones%5B1%5D%5Bcity_code%5D=433&phones%5B1%5D%5Bnumber%5D=34343434&phones%5B1%5D%5Badditional%5D=34&email=dosm21111%40madddf.ru&company_opf=%D0%9E%D0%90%D0%9E&company_name=Vector&company_description=ExampleDescription.&id_town=12&receive_recommendation=on&received_resume_notification=1&subscribe_news=on&user_rights%5B0%5D=view_vacs&user_rights%5B1%5D=master&user_rights%5B2%5D=manage_users&user_rights%5B3%5D=create_vacs&user_rights%5B4%5D=buy_resumes&user_rights%5B5%5D=edit_companyinfo&user_rights%5B6%5D=create_traineeships
                    

Обновление

PUT /2.0/hr/user/555/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    login=newloginexample&password=ReallyHardPasswordExample&lastname=Ivanov&firstname=Sergei&middlename=Ivanovitch&birthday=1&birthmonth=2&birthyear=1984&position=Engineer&phones%5B0%5D%5Bcountry_code%5D=7&phones%5B0%5D%5Bcity_code%5D=498&phones%5B0%5D%5Bnumber%5D=999-88-88&phones%5B0%5D%5Badditional%5D=2054&phones%5B1%5D%5Bcountry_code%5D=3&phones%5B1%5D%5Bcity_code%5D=433&phones%5B1%5D%5Bnumber%5D=34343434&phones%5B1%5D%5Badditional%5D=34&email=dosm21111%40madddf.ru&company_opf=%D0%9E%D0%90%D0%9E&company_name=Vector&company_description=ExampleDescription.&id_town=12&receive_recommendation=on&received_resume_notification=1&subscribe_news=on&user_rights%5B0%5D=view_vacs&user_rights%5B1%5D=master&user_rights%5B2%5D=manage_users&user_rights%5B3%5D=create_vacs&user_rights%5B4%5D=buy_resumes&user_rights%5B5%5D=edit_companyinfo&user_rights%5B6%5D=create_traineeships
                    

Удаление

DELETE /2.0/hr/user/555/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token
Ответ

POST:

201 со следующим содержимым:

{
                        "id": 5646546464,
                        "access_token":"77f724f3f7ffcd00d4a0625aff051d91eaa133cb",
                        "refresh_token":"b3a92f9ee090ef6666a33b604121d198",
                        "ttl":1394748311
                }

Ответ включает себя id созданного пользователя и Access Token.


PUT:

200 со следующим содержимым:

{
                        "id": 5646546464,
                        "access_token":"77f724f3f7ffcd00d4a0625aff051d91eaa133cb",
                        "refresh_token":"b3a92f9ee090ef6666a33b604121d198",
                        "ttl":1394748311
                }

Ответ включает себя id пользователя и Access Token. При смене логина или пароля все текущие токены пользователя удаляются и выдаётся новый.


DELETE:

204 без контента

Список пользователей компании
Resource information
Url https://api.superjob.ru/2.0/user/list/
HTTP Method GET
Аутентификация Требуется
Список да
Пример запроса
GET https://api.superjob.ru/2.0/user/list/
Ответ
{
    "objects":{
        "1":{
        "id":1,
        "email":"example@example.com",
        "name":"Вектор", //....
        },
        "200000001":{
            "id":200000001,
            "email":"example1@example.com", ///...

        }, //....
    },
    "more":false,
    "total":40
}

Параметры объекта

Каждый элемент объекта objects совпадает по структуре с /user/current/.

Поиск резюме
Resource information
Url https://api.superjob.ru/2.0/resumes/
HTTP Method GET
Аутентификация Требуется для вывода контактов
Список да
Параметры
Название Тип Описание
period int Время публикации резюме. Список возможных значений:
0 — за все время
1 — за последние 24 часа
3 — за последние 3 дня
7 — за последнюю неделю
14 — за последние 2 недели
30 — за последний 1 месяц
60 — за последние 2 месяца
id_cv int ID резюме
ids array of int Массив, состоящий из ID резюме. Может содержать не более 500 id.
keyword string Ключевое слово. Ищет по всему резюме
keywords array Расширенный поиск ключевых слов. Каждый элемент массива есть массив со следующими параметрами:
Название Тип Can be empty Описание
srwsintДаИскать в...
Список возможных значений:
  2 — месте проживания
  3 — ключевых навыках
  6 — образовании и курсах
  8 — названии организации
  50 — опыте работы
  60 — желаемой должности
  7 — тексте всего резюме
skwcstringДаКак искать.
Список возможных значений:
  and — все слова
  or — хотя бы одно слово
  particular — точную фразу
  nein — слова-исключения
keysstringНетКлючевое слово
exclude_words string Слова-исключения. Пробел - условие И, запятая - условие ИЛИ.
id_subs int ID подборки на резюме. Требует авторизации под создателем подборки
id_vac int ID вакансии. Требует авторизации под создателем вакансии. Используется для поиска подходящих резюме.
hide_viewed int=1 Скрывать резюме, просмотренные сотрудником компании (установите параметр в 1).
hide_viewed_of_client_users int=1 Скрывать резюме, просмотренные сотрудниками компании (установите параметр в 1).
order_field <string:rank|date|payment> Сортировка: date - по дате публикации, payment - по сумме оклада. По умолчанию - rank.
order_direction <string:asc|desc> Направление сортировки: asc - прямая, desc - обратная. По умолчанию - desc.
payment_from int Сумма оклада от
payment_to int Сумма оклада до
no_agreement int=1 Не показывать оклад «по договоренности» (установите параметр в 1).
town string|int Название города или его ID
t array Массив с ID городов
o array Массив с ID областей
c array Массив с ID стран
metro array Массив с ID метро
catalogues int|commalist Список разделов каталога отраслей. Список значений можно узнать из метода catalogues, параметр key в любом объекте
experience_from int Опыт работы в месяцах. Нижняя граница интервала: например, от 12 месяцев
experience_to int Опыт работы в месяцах. Верхняя граница интервала: например, до 36 месяцев
place_of_work int Место работы. Возможные значения.
moveable int Готовность к переезду.
Список возможных значений:
  1 — Живет в регионе или готов к переезду куда-либо
  2 — Живет в регионе или готов к переезду в него
  3 — Не живет в регионе, но готов к переезду в него
  4 — Живет в регионе
type_of_work int Тип занятости. Возможные значения.
id_institute int ID ВУЗа. Значения можно получить в методе /institutes.
age_from int Возраст от.
age_to int Возраст до.
gender int Пол. Возможные значения.
education int Образование. Возможные значения.
citizenship array of int Гражданство. 0 - не имеет значения. Остальные возможные значения совпадают с id стран из метода /countries.
driving_licence array Наличие водительских прав. Содержит одно или несколько наименований категорий прав: ['A', 'B', 'C', 'D', 'E']
languages array of arrays Поиск по иностранным языкам. Состоит из массива, каждый элемент которого есть массив, который содержит следующие параметры:
language_idint Иностранный язык. Значения можно также получить в справочниках (language).
language_levelint Уровень владения иностранным языком. Возможные значения.
business_trip int Готовность к командировкам. Список возможных значений:
  1 — не готов
  2 — готов
Значения можно также получить в справочниках.
marital_status int Семейное положение. Список возможных значений:
  2 — состоит в браке
  3 — не состоит в браке
Значения можно также получить в справочниках.
children int Наличие детей. Список возможных значений:
  2 — нет
  3 — есть
Значения можно также получить в справочниках.
education_form int Форма обучения. Список возможных значений:
   10 — Дневная/Очная
   20 — Вечерняя
   30 — Очно-заочная
   40 — Заочная
   50 — Экстернат
   60 — Дистанционная
Значения можно также получить в справочниках ('education_form_resume').
portfolio int=1 Показывать только резюме с портфолио (установите параметр в 1).
has_photo int=1 Показывать только резюме с фотографией (установите параметр в 1).
id_search_session int ID поисковой сессии (не обязателен). Если передан ID поисковой сессии, то поиск будет сохранен в данной сессии, а не новой
Пример запроса
GET https://api.superjob.ru/2.0/resumes/?keyword=%D0%B4%D0%B8%D1%80%D0%B5%D0%BA%D1%82%D0%BE%D1%80&order_field=payment&citizenship%5B0%5D=1&order_direction=desc&period=30&payment_from=10000&payment_to=290000&no_agreement=1&town=4&catalogues%5B0%5D=100&catalogues%5B1%5D=86&catalogues%5B2%5D=478&catalogues%5B3%5D=306&catalogues%5B4%5D=327&catalogues%5B5%5D=438&catalogues%5B6%5D=76&catalogues%5B7%5D=11&catalogues%5B8%5D=381&catalogues%5B9%5D=1&catalogues%5B10%5D=33&age_from=20&age_to=60&place_of_work=1&type_of_work=6&moveable=1&gender=2&education=2&driving_licence%5B0%5D=B&driving_licence%5B1%5D=C&languages%5B0%5D%5Blanguage_id%5D=1&languages%5B0%5D%5Blanguage_level%5D=5&languages%5B1%5D%5Blanguage_id%5D=2&languages%5B1%5D%5Blanguage_level%5D=3&business_trip=2&marital_status=2&children=3&education_form=10&has_photo=1
Ответ
{
        "objects":
        [
            {
                "id":1111111,
                "id_user":11111110000,
                "last_profession":"Руководитель проекта",
                "payment":200000,
                "currency":"rub",
                "birthday":01,
                "birthmonth":01,
                "birthyear":1979,
                "age":34,
                "link":"https://www.superjob.ru/resume/cv-1111111.html",
                "metro":[
                    {
                        "id":207,
                        "title":"Балтийская",
                        "id_metro_line":13
                    }
                ],
                "address":"Литейный",
                "citizenship":{
                    "id":1,
                    "title":"Россия"
                },
                "published":{
                    "id":0,
                    "title":"Закрытый доступ"
                },
                "moveable":true,
                "agreement":false,
                "is_archive":false,
                "moveable_towns":[
                    {
                        "id":793,
                        "title":"Таллинн"
                    },
                    {
                        "id":1354,
                        "title":"Город за рубежом"
                    }
                ],
                "type_of_work":{
                    "id":6,
                    "title":"полный рабочий день"
                },
                "place_of_work":{
                    "id":1,
                    "title":"на территории работодателя"
                },
                "education":{
                    "id":2,
                    "title":"Высшее"
                },
                "maritalstatus":{
                    "id":2,
                    "title":"cостоит в браке"
                },
                "children":{
                    "id":3,
                    "title":"есть"
                },
                "business_trip":{
                    "id":0,
                    "title":"не имеет значения"
                },
                "languages":[
                    [
                        {
                        "id":1,
                        "title":"Английский"
                        },
                        {
                        "id":7,
                        "title":"Разговорный"
                        }
                    ],
                    [
                        {
                        "id":2,
                        "title":"Немецкий"
                        },
                        {
                        "id":3,
                        "title":"Базовый"
                        }
                    ]
                ],
                "driving_licence":["B"],
                "catalogues":[
                    {
                        "id":1,
                        "title":"Административная работа, секретариат, АХО",
                        "positions":[
                            {
                                "id":4,
                                "title":"Делопроизводство, ввод данных,систематизация"
                            }
                        ]
                    },
                    {
                        "id":438,
                        "title":"Продажи",
                        "positions":[
                            {
                                "id":445,
                                "title":"Канцелярские товары"
                            },
                            {
                                "id":449,
                                "title":"Мебель"
                            }
                        ]
                    }
                ],
                "town":{
                    "id":14,
                    "title":"Санкт-Петербург",
                    "declension":"в Санкт-Петербурге",
                    "genitive":"Санкт-Петербурга"
                },
                "region":{
                    "id":3,
                    "title":"Центральный округ"
                },
                "experience_text":false,
                "experience_month_total":0,
                "work_history":[
                    {
                        "town":null,
                        "name":"НИИ",
                        "profession":"Руководитель проекта",
                        "work":"Работа, подготовка каталога и контента сайта.",
                        "type":{
                            "id":2,
                            "title":"Полная занятость"
                        },
                        "monthbeg":3,
                        "monthend":7,
                        "yearbeg":2006,
                        "yearend":2008
                    },
                    {
                        "town":null,
                        "name":"ООО Вектор",
                        "profession":"Генеральный директор",
                        "work":"Обязанности: контроль и планирование бюджетов. Достижения: рост продаж на 145%",
                        "type":{
                            "id":2,
                            "title":"Полная занятость"
                        },
                        "monthbeg":2,
                        "monthend":6,
                        "yearbeg":2004,
                        "yearend":2006
                    }
                ],
                "base_education_history":[
                    {
                        "institute":{
                            "id":559,
                            "title":"Санкт-Петербургский государственный политехнический университет"
                        },
                        "town":{
                            "id":14,
                            "title":"Санкт-Петербург",
                            "declension":"в Санкт-Петербурге",
                            "genitive":"Санкт-Петербурга"
                        },
                        "faculty":"Физико-механический",
                        "profession":"Аэродинамика",
                        "education_type":{
                            "id":2,
                            "title":"Высшее"
                        },
                        "education_form":{
                            "id":10,
                            "title":"Дневная/Очная"
                        },
                        "yearend":1992
                    }
                ],
                "education_history":[
                    {
                        "institute":"Открытый Университет",
                        "town":{
                            "id":4,
                            "title":"Москва",
                            "declension":"в Москве",
                            "genitive":"Москвы"
                        },
                        "name":"Управление ресурсами",
                        "yearend":2000
                    }
                ],
                "firstname":"Матвей",
                "middlename":"Матвеевич",
                "lastname":"Травкин",
                "phone1":"+ 7 495 984-77-74",
                "timebeg1":08,
                "timeend1":20,
                "phone2":"7(900)000-00-00",
                "timebeg2":8,
                "timeend2":24,
                "email":"matvey@superjob.ru",
                "other_contacts":"skype:superjob.ru",
                "social_links":[
                    {
                        "id":1,
                        "title":"Вконтакте",
                        "link":"https:\/\/vk.com\/superjob"
                    },
                    {
                        "id":8,
                        "title":"Github",
                        "link":"https:\/\/github.com\/mygithub"
                    }
                ],
                "favorite":true,
                "date_view":1422280247,
                "received_resume_info":{
                    "status":20,
                    "id_user":1,
                    "id_last_vac":0,
                    "display_contacts":1,
                    "new_event":0,
                    "events": []
                },
                "inbox_info":{
                    "resume_status_title":"На рассмотрении",
                    "is_incoming":true,
                    "receipt_way":{
                        "type":40,
                        "text":"Найдено самостоятельно",
                        "date_event":1422005252,
                        "covering_letter":null
                    },
                    "last_event_info":{
                        "type":90,
                        "text":"Отправлено письмо «Приглашаем на работу»",
                        "date_event":1422005270,
                        "covering_letter":null
                    }
                },
                "comments":[
                    {
                        "id": 1,
                        "text":"Комментарий к резюме",
                        "author":null,
                        "date":1422282118
                    },
                    {
                        "id": 2,
                        "text":"comment",
                        "author": "Иришка Иванова",
                        "date":1422282114
                    }
                ],
                "gender":{
                    "id":2,
                    "title":"мужской"
                },
                "achievements":"За годы раздумий и тягостный открытий",
                "additional_info":"Человека описать - не поле перейти.",
                "date_published":1387395261,
                "date_last_modified":1387395262,
                "profession":"Руководитель отдела развития",
                "recommendations":"Иванов Иван Иванович, гл. бухгалтер ООО Вектор.",
                "photo": null,
                "portfolio":[
                    {
                        "source":"https:\/\/public.superjob.ru\/images\/portfolio_photos\/906\/48\/269062931_source.jpg",
                        "resized":"https:\/\/public.superjob.ru\/images\/portfolio_photos\/906\/48\/2604197_resized_f513.jpg"
                    },
                    {
                        "source":"https:\/\/public.superjob.ru\/images\/portfolio_photos\/906\/48\/2696434211_source.jpg",
                        "resized":"https:\/\/public.superjob.ru\/images\/portfolio_photos\/906\/48\/2634211_resized_f513.jpg"
                    }
                ]
            }
        ],
        "more":false,
        "total":5,
        "id_search_session":0
}

Параметры объекта в массиве objects

Название Тип Can
be
empty
Описание
id int Нет ID резюме
id_user int Нет ID пользователя
last_profession string Да Последняя профессия
link string Нет Ссылка на резюме
payment int Да Сумма оклада (если не указано - "по договоренности")
currency string Нет Валюта.
Список возможных значений:
  rub — рубль
  uah — гривна
  uzs — сум
hide_birthday bool Нет Скрыта ли дата рождения. Если скрыта, то значения полей birthday, birthmonth и birthyear заполняются нулями
birthday int Нет Дата рождения: день месяца
birthmonth int Нет Дата рождения: месяц
birthyear int Нет Дата рождения: год
age int Нет Количество полных лет на данный момент.
metro array Да Список станций метро. Каждый элемент массива есть объект, который содержит ID в ключе id, название станции в ключе 'title' и ID ветки в 'id_metro_line'
address string Да Адрес соискателя
citizenship object Да Гражданство. Объект содержит ID страны в ключе id, название страны в ключе 'title'.
published object Нет Тип доступа. Объект содержит ID типа доступа в ключе id, название доступа в ключе 'title'
Список возможных значений:
  0 — закрытый доступ
  1 — открытый доступ
  4 — отказано в публикации
  10 — выборочный доступ
  100 — черновик
moveable bool Нет Соискатель готов к переезду
agreement bool Нет Оклад по договоренности
receive_sms bool Да Получать SMS от работодателей
is_archive bool Нет Находится ли резюме в архиве
moveable_towns array Да Список городов, в которые соискатель готов переехать. Каждый элемент массива есть объект, который содержит ID в ключе 'id' и название города в ключе 'title'.
Значения можно также получить в /towns.
type_of_work object Нет Тип занятости. Объект содержит ID в ключе 'id' и название типа занятости в ключе 'title'.
Список возможных значений:
  0 — не имеет значения
  6 — полный день
  10 — неполный день
  12 — сменный график
  13 — частичная занятость
  7 — временная работа
  9 — вахтовым методом
Значения можно также получить в справочниках.
place_of_work object Нет Место работы. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  0 — не имеет значения
  1 — на территории работодателя
  2 — на дому
  3 — разъездного характера
Значения можно также получить в справочниках.
education object Нет Образование. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  2 — Высшее
  3 — Неполное высшее
  4 — Среднее специальное
  5 — Среднее
  6 — Учащийся школы
  7 — Бакалавр
  8 — Магистр
  9 — Кандидат наук
  10 — Доктор наук
Значения можно также получить в справочниках.
maritalstatus object нет Семейное положение. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  2 — состоит в браке
  3 — не состоит в браке
Значения можно также получить в справочниках.
children object нет Наличие детей. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  2 — нет
  3 — есть
Значения можно также получить в справочниках.
business_trip object Да Готовность к командировкам. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  1 — не готов
  2 — готов
Значения можно также получить в справочниках.
languages array Да Наименование и уровень владения иностранными языками. Каждая пара язык\уровень – это отдельный массив.
[[{"id":1,"title": "Английский"},{"id":9,"title": "Cвободное владение"}]]

Первый элемент массива Наименование иностранного языка: объект, который содержит ID в ключе 'id' и название языка в ключе 'title'.
Второй элемент массива Уровень владения языком: объект, который содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  3 — базовый
  5 — технический
  7 — разговорный
  9 — свободное владею
Значения можно также получить в справочниках.
driving_licence array Да Наличие водительских прав. Содержит одно или несколько наименований категорий прав: ['A', 'B', 'C', 'D', 'E']
catalogues array Нет Список категорий и отраслей резюме. Каждый элемент массива есть объект (отрасль), который содержит ID в ключе 'id' и название каталога в ключе 'title'. Кроме того, есть массив 'positions', который содержит категории каталога. В массиве находится точно такой же по структуре объект - категория.
town object Нет Город. Содержит ID в ключе 'id' и название города в ключе 'title', а также склонение в ключе 'declension' и родительный падеж в ключе 'genitive'
region object Нет Округ. Содержит ID в ключе 'id' и название округа в ключе 'title'
experience_text string|false Да Описание количества оптыта работы
experience_month_count int Нет Опыт работы в месяцах
work_history array Да Опыт работы. Каждый элемент массива есть объект, который содержит:
Название Тип Can
be
empty
Описание
townobjectДаГород
namestringДаНаименование организации
professionstringНетДолжность
workstringДаДолжностные обязанности
typeobjectДаТип занятости. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  2 — Полная занятость
  3 — Частичная занятость
  4 — Временная занятость
Значения можно также получить в справочниках ('work_type').
monthbegintНетНачало работы в организации (месяц)
yearbegintНетНачало работы в организации (год)
monthendintДаОкончание работы в организации (месяц)
yearendintДаОкончание работы в организации (год)
base_education_history array Да Уровень образования. Каждый элемент массива есть объект, который содержит:
Название Тип Can
be
empty
Описание
instituteobjectДаУчебное заведение. Объект содержит ID в ключе 'id' и название в ключе 'title'. Значения можно получить в методе /institutes.
townobjectДаГород
facultystringДаФакультет
professionstringДаСпециальность
workstringДаДолжностные обязанности
education_typeobjectНетУровень образования. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
   2 — Высшее
   3 — Неполное высшее
   4 — Среднее специальное
   5 — Среднее
   6 — Учащийся школы
   7 — Бакалавр
   8 — Магистр
   9 — Кандидат наук
   10 — Доктор наук
Значения можно также получить в справочниках ('education_type_resume').
education_formobjectДаФорма обучения. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
   10 — Дневная/Очная
   20 — Вечерняя
   30 — Очно-заочная
   40 — Заочная
   50 — Экстернат
   60 — Дистанционная
Значения можно также получить в справочниках ('education_form_resume').
yearendintДаГод выпуска
education_history array Да Курсы и тренинги. Каждый элемент массива есть объект, который содержит:
Название Тип Can
be
empty
Описание
institutestringДаУчебное заведение
townobjectДаГород
namestringНетНаименование курсов или тренингов
yearendintНетГод завершения курсов
firstname string Да* Имя
middlename string Да* Отчество
lastname string Да* Фамилия
name string Да* Имя и фамилия
phone1 string Да* Телефон. Доступен если контакты резюме были куплены, при этом резюме было просмотрено или оно находятся в откликах
timebeg1 string Да* Время звонка с
timeend1 string Да* Время звонка по
phone2 string Да* Телефон. Доступен если контакты резюме были куплены, при этом резюме было просмотрено или оно находятся в откликах
timebeg2 string Да* Время звонка с
timeend2 string Да* Время звонка по
phones array Да* Массив с телефонами phone1 и phone2 (алиас)
email string Да* Электронная почта. Доступна если контакты резюме были куплены, при этом резюме было просмотрено или оно находятся в откликах
other_contacts string Да* Другие контакты
socialProfiles array Да* Профаилы в социальных сетях. Доступны если контакты резюме были куплены, при этом резюме было просмотрено или оно находятся в откликах
social_links array Да* Список ссылок на социальные сети. Каждый элемент массива есть объект, который содержит ID в ключе id, название соцети в ключе 'title' и ссылку на профиль в 'link'. Значения id можно получить в справочниках ('social_links_resume'). Доступны если контакты резюме были куплены, при этом резюме было просмотрено или оно находятся в откликах
gender object Нет Пол. Объект содержит ID в ключе 'id' и название в ключе 'title'.
Список возможных значений:
  2 — мужской
  3 — женский
Значения можно также получить в справочниках ('gender_resume').
date_view bool Да** Дата просмотра резюме работодателем
resume_price int Да** Стоимость покупки резюме
received_resume_info object Да** Информация о резюме, если оно находится в откликах ("Полученные резюме")
Название Тип Can
be
empty
Описание
statusstringНетСтатус резюме. Значения можно посмотреть здесь.
id_userintДаID пользователя, совершившего последнее действие над резюме
id_last_vacintДаID вакансии, на которую было прислано резюме
new_eventintНетПризнак новизны полученного резюме. Возможные значения:
        * 0 = нет нового события
        * 30 = получено по подписке
        * 60 = получено от другого
        * 90 = прислано Соискателем
eventsarrayДаМассив с событиями полученного резюме
inbox_info object Да* Информация о статусе рассмотрения резюме
Название Тип Can
be
empty
Описание
resume_status_titlestringНетТекстовое описание cтатуса резюме.
is_incomingboolНетПолучено ли резюме текущим пользователем
receipt_wayobjectДаДанные о способе получения резюме
Название Тип Can
be
empty
Описание
typeintНетТип способа получения резюме. Значения можно посмотреть здесь.
textstringДаОписание способа получения резюме
date_eventintНетДата получения резюме
covering_letterstringДаСопроводительное письмо
last_event_infoobjectДаДанные о последнем событии, произведённым над резюме
Название Тип Can
be
empty
Описание
typeintНетТип события. Значения можно посмотреть здесь.
textstringДаОписание события
date_eventintНетДата события
covering_letterstringДаСопроводительное письмо
id_last_vacintНетID вакансии, на которую присылалось резюме. Если вакансию невозомжно указать - 0
comments array of objects Да** Комментарии сотрудников компании ко всем резюме пользователя. Каждый элемент массива есть объект со следующими параметрами:
Название Тип Can
be
empty
Описание
idintНетID комментария
id_resumeintНетID резюме
textstringНетКомментарий к резюме.
authorstringДаИмя и фамилия пользователя, оставившего комментарий, если он отличается от текущего.
dateintНетДата комментария.
achievements string Да Достижения
additional_info string Да Дополнительная информация
recommendations string Да* Рекомендации
profession string Нет Профессия
date_published int (unixtime) Нет Дата публикации
date_last_modified int (unixtime) Нет Дата последнего редактирования резюме
photo string Да Ссылка на фотографию
portfolio array of objects Да Портфолио. Каждый элемент массива есть объект, который содержит:
Название Тип Can
be
empty
Описание
sourcestringНетИсходное изображение портфолио
resizedstringНетУменьшенное до 150x100 изображение портфолио

* — поля, доступные после авторизации как соискатель или если контакты приобретены работодателем (доступны всегда в случае безлимитного тарифа)

** — поля, доступные в случае наличия резюме у работодателя в откликах

Метод выдаёт резюме только в открытом доступе.

Для авторизованных запросов:
- соискатель может видеть контакты своих резюме;
- работодатель может видеть контакты резюме согласно его тарифу
(доступны оплаченные контакты и котакты полученных резюме; или все контакты в случае безлимитного тарифа).

В ответе так же передается параметр id_search_session (int, не может быть пустым) - ID поисковой сессии для данного поиска

История поиска резюме
Resource information
Url https://api.superjob.ru/2.0/hr/resumes/search_history/
HTTP Method GET
Аутентификация Требуется
Список нет
Пример запроса
GET https://api.superjob.ru/2.0/hr/resumes/search_history/
Host: api.superjob.ru
X-Api-App-Id: yourAppSecretKey
Authorization: Bearer h.000000000000001.example.token
Ответ
{
    "items": [
        {
            "url": "http://www.superjob.ru/resume_search_history?id=123",
            "parameters": {...},
            "payment": "от&nbsp;10 000&nbsp;до&nbsp;50 000&nbsp;руб.",
            "town_name": "Москва",
            "date": "2 мая",
            "new_resumes_count": 100
        },
        ...
    ]
}

Параметры объектов массива items в ответе:

Название Тип Описание
url string Ссылка на поиск
parameters object Объект параметров поиска
payment string Форматированная сумма оклада (пустая строка, если сумма оклада не указана)
town_name string Город
date string Форматированные дата/время поиска
new_resumes_count int Количество новых резюме в поиске
Резюме пользователя
Resource information
Url https://api.superjob.ru/2.0/resumes/:id/
HTTP Method GET
Аутентификация Требуется
Список нет
Пример запроса
GET https://api.superjob.ru/2.0/resumes/555/
Ответ
{
        "id":1111111,
        "id_user":11111110000,	// ...
    }
    

Описание параметров, см. здесь

Вакансии
Resource information
Url https://api.superjob.ru/2.0/vacancies/
HTTP Method GET - поиск, POST - создание вакансии.
PUT и DELETE для пакетного обновления
и удаления вакансий соответственно
Пакетная обработка Возможна для создания/удаления/обновления вакансий.
Запрос должен содержать массив vacancies
Аутентификация Требуется для создания.
В случае поиска, нужна для вывода контактов.
Если контакты не нужны - не требуется
Список да
Параметры

Параметры поиска вакансий см. здесь.

Параметры создания вакансии см. здесь.

Ответ

GET:

{
            "objects":[
            {
                "id": 25746005,
                "id_client": 544932,
                // ...
            }
            ],
            "total": 1000000,
            "more":false
    }

Параметры объекта в массиве objects см. здесь


Без авторизации или без явного указания published, показываются только вакансии в открытом доступе.

POST:

201 со следующим содержимым:

{"id": 5646546464 }

Ошибки см. здесь.

Вакансия
Resource information
Url https://api.superjob.ru/2.0/vacancies/:id/
(пример по ссылке)
HTTP Method GET - получение, PUT — обновление записи,
DELETE — удаление записи
Аутентификация Требуется для обновления и удаления.
В случае получения, нужна вывода контактов
Список нет
Входные параметры
Название Тип Обязательный Описание
:id int да ID вакансии

Параметры обновления/создания вакансии
Название Тип Обязательный Описание
profession string Да Название вакансии
turbo int нет Турбо-вакансия или нет
Список возможных значений:
  0 — обычная
  1 — турбо
town int Да Город. Значения можно получить в /towns.
published int Да Тип доступа.
Список возможных значений:
  0 — закрытый доступ
  1 — открытый доступ
id_user int Нет ID пользователя, от которого будет опубликована вакансия. Этот пользователь, наряду с текущим, должен обрадать соответствующими правами. Список пользователей можно получить в /user/list/.
catalogues array Да Сфера деятельности. Каждый элемент массива содержит ID категории каталога. Значения можно получить в методе /catalogues. Максимальное количество разделов каталога — 5. Нельзя посылать отрасль (раздел каталога, у которого отсутствует id_parent).
code string Нет Код вакансии
external_url string Нет*** URL внешнего сайта. Используется, чтобы перенаправлять соискателей на указанный ресурс.
*** - Применяется только в случае наличия соответствующего тарифа
work string Нет Должностные обязанности
compensation string Нет Условия работы
candidat string Нет Требования к кандидату
type_of_work int Нет Тип занятости.
Список возможных значений:
  6 — полный день
  10 — неполный день
  12 — сменный график
  13 — частичная занятость
  7 — временная работа
  9 — вахтовым методом

Значения можно также получить в справочниках.
place_of_work int Нет Место работы.
Список возможных значений:
  1 — на территории работодателя
  2 — на дому
  3 — разъездного характера

Значения можно также получить в справочниках.
education int Нет Образование
Список возможных значений:
  2 — высшее
  3 — неполное высшее
  4 — средне-специальное
  5 — среднее
  6 — учащийся

Значения можно также получить в справочниках.
experience int Нет Опыт работы
Список возможных значений:
  1 — без опыта
  2 — от 1 года
  3 — от 3 лет
  4 — от 6 лет

Значения можно также получить в справочниках.
maritalstatus int Нет Семейное положение
Список возможных значений:
  0 — не имеет значения
  2 — состоит в браке
  3 — не состоит в браке

Значения можно также получить в справочниках.
children int Нет Наличие детей
Список возможных значений:
  0 — не имеет значения
  2 — нет
  3 — есть

Значения можно также получить в справочниках.
languages array of arrays Нет Наименование и уровень владения иностранными языками.
Структура, следующего вида:
array(
        0 => array(
            'id_language' => 4,
            'level' => 1
        ),
        1 => array( ... ),
        // ....
    )
    

Описание элемента массива:
Название Тип Обязательный Описание
id_languageintдаНазвание языка. Значения можно получить в справочниках (language).
levelintдаУровень владения языком. Значения можно получить в справочниках (lang_level).
contact string Нет Имя контактного лица
email string Нет Адрес почты
url string Нет Адрес сайта компании
phones array of arrays Нет Десятизначный номер телефона
Структура, следующего вида:
array(
        0 => array(
            'country_code' => 7,
            'city_code' => 499,
            'number' => 7870000,
            'additional' => 'Доб. 03'
        ),
        1 => array( ... ),
        // ....
    )
    

Описание элемента массива:
Название Тип Обязательный Описание
country_codeintдаКод страны
city_codeintдаКод города
numberintдаНомер телефона
additionalstringнетДобавочный номер телефона
driving_licence array of strings Нет Наличие водительских прав. Каждый элемент массива содержит одно наименование категорий прав: 'A', 'B', 'C', 'D', 'E'
metro array Нет Метро. Каждый элемент массива содержит id станции метрополитена. Список доступных значений см. здесь.
payment_from int Нет Сумма оклада от
payment_to int Нет Сумма оклада до
moveable bool Нет Рассматриваются соискатели из других городов
gender int Нет Пол
Список возможных значений:
  0 — не имеет значения
  2 — мужской
  3 — женский

Значения можно также получить в справочниках.
age_from int Нет Возраст от
age_to int Нет Возраст до
firm_name string Да Название компании
firm_activity string Да Описание деятельности компании
address string Нет Адрес работодателя
anonymous bool Нет Анонимная ли вакансия (0 - нет, 1 - да).
refresh_vac bool Нет Обновлять ли вакансию автоматически (0 - нет, 1 - да).
extend_vac bool Нет Продлять ли вакансию автоматически (0 - нет, 1 - да).
resumesubscription_status bool Нет Включить ли подписку на резюме (0 - нет, 1 - да).
resumesubscription_keywords string Нет Ключевые слова подписки на резюме
resumesubscription_kwc string Нет Как искать слова в подписке на резюме.
Возможные значения:
or — хотя бы одно слово
and — все слова
particular — точная фраза.
resumesubscription_rws int Нет Где искать слова в подписке на резюме.
Возможные значения:
7 — по опыту
250 — по последнему опыту
50 — по всему резюме
60 — по желаемой должности
8 — по названию организации
3 — по ключевым навыкам
6 — по образованию и курсам
2 — по месту проживания.
Пример запроса

Обновление

PUT /2.0/vacancies/555/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    published=1&town=4&moveable=0&old1=22&pol=2&payment_to=90000&type_of_work=13&place_of_work=1&education=3&drive_license%5B0%5D=A&drive_license%5B1%5D=B&drive_license%5B2%5D=C&drive_license%5B3%5D=D&drive_license%5B4%5D=E&profession=UI-web+designer&code=616516&work=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD+%D0%B8+%D0%BF%D1%80%D0%BE%D1%87%D0%B8%D0%B5+%D0%BE%D0%B1%D1%8F%D0%B7%D0%B0%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D0%B8&compensation=%D0%9F%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9+%D1%81%D0%BE%D1%86%D0%BF%D0%B0%D0%BA%D0%B5%D1%82&url=www.example.ru&mail=example%40mail.ru&firm_name=%D0%9E%D0%9E%D0%9E+%D0%92%D0%B5%D0%BA%D1%82%D0%BE%D1%80&contact=%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2+%D0%98%D0%B2%D0%B0%D0%BD&firm_activity=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD-%D1%81%D1%82%D1%83%D0%B4%D0%B8%D1%8F.&candidat=%D0%92%D0%B5%D1%80%D1%81%D1%82%D0%BA%D0%B0+%D0%B8+%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5+%D0%BC%D0%B0%D0%BA%D0%B5%D1%82%D0%BE%D0%B2+%D0%B4%D0%BB%D1%8F+%D0%B6%D1%83%D1%80%D0%BD%D0%B0%D0%BB%D0%BE%D0%B2&maritalstatus=1&children=3&address=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0%2C+%D0%9C%D0%B0%D0%BB%D1%8B%D0%B9+%D0%BF%D0%B5%D1%80%D0%B5%D1%83%D0%BB%D0%BE%D0%BA%2C+%D0%B4.+2&refresh_vac=1&anonymous=0&metro%5B0%5D=120&metro%5B1%5D=2&catalogues%5B0%5D=35&catalogues%5B1%5D=36&catalogues%5B2%5D=37&catalogues%5B3%5D=38&catalogues%5B4%5D=546&experience=3&resumesubscription_status=0&resumesubscription_kwc=or&resumesubscription_rws=7&phones%5B0%5D%5Badditional%5D=456654&phones%5B0%5D%5Bcountry_code%5D=7&phones%5B0%5D%5Bcity_code%5D=495&phones%5B0%5D%5Bnumber%5D=7907277
                    

Удаление

DELETE /2.0/vacancies/555/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

Удалить можно только вакансию, которая находится в архиве.

Создание

POST /2.0/vacancies/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    published=1&town=4&moveable=1&old1=22&old2=99&pol=2&payment_from=10000&payment_to=90000&type_of_work=13&place_of_work=1&education=3&drive_license%5B0%5D=A&drive_license%5B1%5D=B&drive_license%5B2%5D=C&drive_license%5B3%5D=D&drive_license%5B4%5D=E&profession=UI-web+designer&code=616516&work=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD+%D0%B8+%D0%BF%D1%80%D0%BE%D1%87%D0%B8%D0%B5+%D0%BE%D0%B1%D1%8F%D0%B7%D0%B0%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D0%B8&compensation=%D0%9F%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9+%D1%81%D0%BE%D1%86%D0%BF%D0%B0%D0%BA%D0%B5%D1%82&url=www.example.ru&mail=example%40mail.ru&firm_name=%D0%9E%D0%9E%D0%9E+%D0%92%D0%B5%D0%BA%D1%82%D0%BE%D1%80&contact=%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2+%D0%98%D0%B2%D0%B0%D0%BD&firm_activity=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD-%D1%81%D1%82%D1%83%D0%B4%D0%B8%D1%8F.&candidat=%D0%92%D0%B5%D1%80%D1%81%D1%82%D0%BA%D0%B0+%D0%B8+%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5+%D0%BC%D0%B0%D0%BA%D0%B5%D1%82%D0%BE%D0%B2+%D0%B4%D0%BB%D1%8F+%D0%B6%D1%83%D1%80%D0%BD%D0%B0%D0%BB%D0%BE%D0%B2&maritalstatus=2&children=3&address=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0%2C+%D0%9C%D0%B0%D0%BB%D1%8B%D0%B9+%D0%BF%D0%B5%D1%80%D0%B5%D1%83%D0%BB%D0%BE%D0%BA%2C+%D0%B4.+2&refresh_vac=1&anonymous=0&metro%5B0%5D=120&metro%5B1%5D=2&catalogues%5B0%5D=35&catalogues%5B1%5D=36&catalogues%5B2%5D=37&catalogues%5B3%5D=38&catalogues%5B4%5D=546&experience=3&resumesubscription_status=0&resumesubscription_kwc=or&resumesubscription_rws=7&phones%5B0%5D%5Badditional%5D=456654&phones%5B0%5D%5Bcountry_code%5D=7&phones%5B0%5D%5Bcity_code%5D=495&phones%5B0%5D%5Bnumber%5D=7907277&languages%5B0%5D%5Blevel%5D=5&languages%5B0%5D%5Bid_language%5D=1
                    
Ответ

GET:

{
        "id":11568334,
        "id_client":14449,
        "date_pub_to":1372409338,
        "date_published":1369817338,
        "profession": "Старший специалист по тестированию",
        //...
}

Параметры объекта см. описание параметров метода vacancies


POST:

201 со следующим содержимым:

{"id": 5646546464 }

PUT:

200 со следующим содержимым:

{"id": 5646546464 }

DELETE:

204 без контента

Ошибки

Ошибка при наличии похожей вакансии:

{
                        "error":{
                            "code":422,
                            "message":{
                                "similar_vacancy":{
                                    "id":"26717549",
                                    "description":"У Вас уже есть размещенная вакансия UI-web designer в городе Москва."
                                }
                            }
                        }
                }

Ошибки валидации при создании/апдейте вакансии:


{
        "error":{
            "code":422,
            "message":{
                "firm_name":[
                    "Обязательное поле"
                ],
                "profession":[
                    "Укажите должность"
                ],
                "catalogues":[
                    "Укажите специализацию",
                    "Вы не выбрали ни одной категории каталога отраслей!"
                ],
                "resumesubscription_status":[
                    "Значение поля Подписка на резюме должно быть числом."
                ],
                "firm_activity":[
                    "Опишите деятельность компании (минимум 5 символов)"
                ]
            }
        }
}
Восстановление вакансии из архива
Resource information
Url https://api.superjob.ru/2.0/vacancies/:id/republish/
HTTP Method PUT
Аутентификация Требуется
Пакетная обработка Возможна.
Запрос должен содержать массив vacancies, содержащий id в качестве элементов.
Список нет
Входные параметры
Название Тип Обязательный Описание
:id int да ID вакансии
turbo int нет Включить или нет турбо-вакансию при повторном размещении
town int нет Город (Смена города работает только при восстановлении из архива, при редактировании смена города запрещена)
Пример запроса
PUT /2.0/vacancies/555/republish/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token
    
Ответ

Пустой ответ с http-кодом 200.

Список вакансий клиента
Resource information
Url https://api.superjob.ru/2.0/hr/vacancies/
HTTP Method GET
Аутентификация Обязательна
Список да
Входные параметры
Название Тип Описание
status string Статус вакансии

Список возможных значений:

  • all - Все вакансии
  • active - В открытом доступе (по-умолчанию)
  • close - В закрытом доступе
  • archive - В архиве
  • refuse - Отклоненные модератором
  • expire_soon - Заканчивающиеся
  • anonymous - Анонимные
  • published - Опубликованные (не архивные и не отклоненные)
  • all_not_archive - Все вакансии не в архиве (включая отклоненные)
id_user int ID пользователя

Используется для фильтра списка вакансий по конкретному пользователю в рамках одной учетной записи клиента. Необходимо наличие прав "просмотр вакансий других пользователей" или "управление вакансиями других пользователей"). Для просмотра списка своих вакансий передача этого параметра не требуется.

town array[int] Массив ID городов

Используется для фильтрации списка вакансий по городам

with_new_response int С новым откликом

Используется для фильтрации списка вакансий по наличию признака "с новым откликом"

Список возможных значений:

  • 0
  • 1
only_turbo int Турбо-вакансии

Используется для показа списка турбо-вакансий

Список возможных значений:

  • 0
  • 1
order_field string Сортировка

Список возможных значений:

  • date - по дате (по-умолчанию)
  • profession - по алфавиту
order_direction string Направление сортировки

Список возможных значений:

  • asc - в прямом порядке
  • desc - в обратном порядке (по-умолчанию)
Пример запроса
GET https://api.superjob.ru/2.0/hr/vacancies/?with_new_response=1&status=active

Формат ответа полностью совпадает с форматом ответа "Поиска вакансий".

Перенос вакансии в архив
Resource information
Url https://api.superjob.ru/2.0/vacancies/:id/archive/
HTTP Method PUT
Аутентификация Требуется
Пакетная обработка Возможна.
Запрос должен содержать массив vacancies, содержащий id в качестве элементов.
Список нет
Входные параметры
Название Тип Обязательный Описание
:id int да ID вакансии
Пример запроса
PUT /2.0/vacancies/555/archive/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token
    
Ответ

Пустой ответ с http-кодом 204. Если вакансия уже в архиве - код 403

Параллельное выполнение запросов
Resource information
Url https://api.superjob.ru/2.0/parallel/
HTTP Method POST
Список нет

Метод поддерживает передачу множественных POST и GET-only (i.e. не REST) запросов к API.

Входные параметры

На вход нужно передать массив, каждый элемент которого есть массив, содержащий ключом url метода API, а его значения - параметры метода.

Считается, что если переданы параметры - будет выполнен POST-запрос, иначе - GET.

Соответственно, если вам нужно выполнить POST-метод, не содержащий параметров, можно передать любые параметры.

Структура данных запроса схематично представлена ниже:

array(3) {
      [0] => array(1) {
        ["https://api.superjob.ru/2.0/user/current/"] => string(0) "" // GET-запрос
      }
      [1] => array(1) {
        ["https://api.superjob.ru/2.0/vacancies/"] => array(37) {
          ["published"] => string(1) "0"
          ["town"] => string(1) "4"
          ["profession"] => string(30) "UI-web designer"
          // ....
        } // POST-запрос
      }
      [2] => array(1) {
        ["https://api.superjob.ru/2.0/vacancies/"] => array(37) {
          ["published"] => string(1) "1"
          ["town"] => string(1) "4"
          ["profession"] => string(29) "PHP-программист"
          // ....
        } // POST-запрос
      }
}
Пример запроса
POST /2.0/parallel/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token


    0%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fuser%2Fcurrent%2F%5D=&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bpublished%5D=0&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Btown%5D=4&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bmoveable%5D=1&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bold1%5D=22&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bold2%5D=99&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bpol%5D=2&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bpayment_from%5D=20598&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bpayment_to%5D=282967&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Btype_of_work%5D=13&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bplace_of_work%5D=1&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Beducation%5D=3&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bdrive_license%5D%5B0%5D=A&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bdrive_license%5D%5B1%5D=B&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bdrive_license%5D%5B2%5D=C&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bdrive_license%5D%5B3%5D=D&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bdrive_license%5D%5B4%5D=E&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bprofession%5D=UI-web+designer1398426283.4009&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcode%5D=616516&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bwork%5D=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD+%D0%B8+%D0%BF%D1%80%D0%BE%D1%87%D0%B8%D0%B5+%D0%BE%D0%B1%D1%8F%D0%B7%D0%B0%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D0%B8&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcompensation%5D=%D0%9F%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9+%D1%81%D0%BE%D1%86%D0%BF%D0%B0%D0%BA%D0%B5%D1%82&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Burl%5D=www.example.ru&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bmail%5D=example%40mail.ru&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bname%5D=%D0%9E%D0%9E%D0%9E+%D0%92%D0%B5%D0%BA%D1%82%D0%BE%D1%80&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcontact%5D=%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2+%D0%98%D0%B2%D0%B0%D0%BD&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcompany%5D=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD-%D1%81%D1%82%D1%83%D0%B4%D0%B8%D1%8F.&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcandidat%5D=%D0%92%D0%B5%D1%80%D1%81%D1%82%D0%BA%D0%B0+%D0%B8+%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5+%D0%BC%D0%B0%D0%BA%D0%B5%D1%82%D0%BE%D0%B2+%D0%B4%D0%BB%D1%8F+%D0%B6%D1%83%D1%80%D0%BD%D0%B0%D0%BB%D0%BE%D0%B2&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bmaritalstatus%5D=2&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bchildren%5D=3&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Baddress%5D=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0%2C+%D0%9C%D0%B0%D0%BB%D1%8B%D0%B9+%D0%BF%D0%B5%D1%80%D0%B5%D1%83%D0%BB%D0%BE%D0%BA%2C+%D0%B4.+2&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Brefresh_vac%5D=1&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Banonymous%5D=0&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bmetro%5D%5B0%5D=120&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bmetro%5D%5B1%5D=2&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcatalogues%5D%5B0%5D=441&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcatalogues%5D%5B1%5D=36&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcatalogues%5D%5B2%5D=37&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcatalogues%5D%5B3%5D=38&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcatalogues%5D%5B4%5D=273&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bexperience%5D=3&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bresumesubscription_status%5D=0&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bresumesubscription_kwc%5D=or&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bresumesubscription_rws%5D=7&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bphones%5D%5B0%5D%5Badditional%5D=456654&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bphones%5D%5B0%5D%5Bcountry_code%5D=7&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bphones%5D%5B0%5D%5Bcity_code%5D=495&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bphones%5D%5B0%5D%5Bnumber%5D=7907277&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Blanguages%5D%5B0%5D%5Blevel%5D=5&1%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Baccess_token%5D=youraccesstoken&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bpublished%5D=0&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Btown%5D=4&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bmoveable%5D=1&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bold1%5D=22&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bold2%5D=99&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bpol%5D=2&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bpayment_from%5D=27059&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bpayment_to%5D=139168&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Btype_of_work%5D=13&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bplace_of_work%5D=1&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Beducation%5D=3&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bdrive_license%5D%5B0%5D=A&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bdrive_license%5D%5B1%5D=B&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bdrive_license%5D%5B2%5D=C&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bdrive_license%5D%5B3%5D=D&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bdrive_license%5D%5B4%5D=E&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bprofession%5D=UI-web+designer1398426283.401&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcode%5D=616516&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bwork%5D=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD+%D0%B8+%D0%BF%D1%80%D0%BE%D1%87%D0%B8%D0%B5+%D0%BE%D0%B1%D1%8F%D0%B7%D0%B0%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D0%B8&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcompensation%5D=%D0%9F%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9+%D1%81%D0%BE%D1%86%D0%BF%D0%B0%D0%BA%D0%B5%D1%82&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Burl%5D=www.example.ru&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bmail%5D=example%40mail.ru&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bname%5D=%D0%9E%D0%9E%D0%9E+%D0%92%D0%B5%D0%BA%D1%82%D0%BE%D1%80&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcontact%5D=%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2+%D0%98%D0%B2%D0%B0%D0%BD&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcompany%5D=%D0%94%D0%B8%D0%B7%D0%B0%D0%B9%D0%BD-%D1%81%D1%82%D1%83%D0%B4%D0%B8%D1%8F.&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcandidat%5D=%D0%92%D0%B5%D1%80%D1%81%D1%82%D0%BA%D0%B0+%D0%B8+%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5+%D0%BC%D0%B0%D0%BA%D0%B5%D1%82%D0%BE%D0%B2+%D0%B4%D0%BB%D1%8F+%D0%B6%D1%83%D1%80%D0%BD%D0%B0%D0%BB%D0%BE%D0%B2&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bmaritalstatus%5D=2&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bchildren%5D=3&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Baddress%5D=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0%2C+%D0%9C%D0%B0%D0%BB%D1%8B%D0%B9+%D0%BF%D0%B5%D1%80%D0%B5%D1%83%D0%BB%D0%BE%D0%BA%2C+%D0%B4.+2&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Brefresh_vac%5D=1&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Banonymous%5D=0&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bmetro%5D%5B0%5D=120&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bmetro%5D%5B1%5D=2&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcatalogues%5D%5B0%5D=425&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcatalogues%5D%5B1%5D=36&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcatalogues%5D%5B2%5D=37&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcatalogues%5D%5B3%5D=38&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bcatalogues%5D%5B4%5D=267&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bexperience%5D=3&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bresumesubscription_status%5D=0&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bresumesubscription_kwc%5D=or&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bresumesubscription_rws%5D=7&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bphones%5D%5B0%5D%5Badditional%5D=456654&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bphones%5D%5B0%5D%5Bcountry_code%5D=7&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bphones%5D%5B0%5D%5Bcity_code%5D=495&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Bphones%5D%5B0%5D%5Bnumber%5D=7907277&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Blanguages%5D%5B0%5D%5Blevel%5D=5&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Blanguages%5D%5B0%5D%5Bid_language%5D=1&2%5Bhttps%3A%2F%2Fapi.superjob.ru%2F2.0%2Fvacancies%2F%5D%5Baccess_token%5D=youraccesstoken

    или в декодированном виде:

    0[https://api.superjob.ru/2.0/user/current/]=&1[https://api.superjob.ru/2.0/vacancies/][published]=0&1[https://api.superjob.ru/2.0/vacancies/][town]=4&1[https://api.superjob.ru/2.0/vacancies/][moveable]=1&1[https://api.superjob.ru/2.0/vacancies/][old1]=22&1[https://api.superjob.ru/2.0/vacancies/][old2]=99&1[https://api.superjob.ru/2.0/vacancies/][pol]=2&1[https://api.superjob.ru/2.0/vacancies/][payment_from]=20598&1[https://api.superjob.ru/2.0/vacancies/][payment_to]=282967&1[https://api.superjob.ru/2.0/vacancies/][type_of_work]=13&1[https://api.superjob.ru/2.0/vacancies/][place_of_work]=1&1[https://api.superjob.ru/2.0/vacancies/][education]=3&1[https://api.superjob.ru/2.0/vacancies/][drive_license][0]=A&1[https://api.superjob.ru/2.0/vacancies/][drive_license][1]=B&1[https://api.superjob.ru/2.0/vacancies/][drive_license][2]=C&1[https://api.superjob.ru/2.0/vacancies/][drive_license][3]=D&1[https://api.superjob.ru/2.0/vacancies/][drive_license][4]=E&1[https://api.superjob.ru/2.0/vacancies/][profession]=UI-web designer1398426283.4009&1[https://api.superjob.ru/2.0/vacancies/][code]=616516&1[https://api.superjob.ru/2.0/vacancies/][work]=Дизайн и прочие обязанности&1[https://api.superjob.ru/2.0/vacancies/][compensation]=Полный соцпакет&1[https://api.superjob.ru/2.0/vacancies/][url]=www.example.ru&1[https://api.superjob.ru/2.0/vacancies/][mail]=example@mail.ru&1[https://api.superjob.ru/2.0/vacancies/][name]=ООО Вектор&1[https://api.superjob.ru/2.0/vacancies/][contact]=Иванов Иван&1[https://api.superjob.ru/2.0/vacancies/][company]=Дизайн-студия.&1[https://api.superjob.ru/2.0/vacancies/][candidat]=Верстка и создание макетов для журналов&1[https://api.superjob.ru/2.0/vacancies/][maritalstatus]=2&1[https://api.superjob.ru/2.0/vacancies/][children]=3&1[https://api.superjob.ru/2.0/vacancies/][address]=Москва, Малый переулок, д. 2&1[https://api.superjob.ru/2.0/vacancies/][refresh_vac]=1&1[https://api.superjob.ru/2.0/vacancies/][anonymous]=0&1[https://api.superjob.ru/2.0/vacancies/][metro][0]=120&1[https://api.superjob.ru/2.0/vacancies/][metro][1]=2&1[https://api.superjob.ru/2.0/vacancies/][catalogues][0]=441&1[https://api.superjob.ru/2.0/vacancies/][catalogues][1]=36&1[https://api.superjob.ru/2.0/vacancies/][catalogues][2]=37&1[https://api.superjob.ru/2.0/vacancies/][catalogues][3]=38&1[https://api.superjob.ru/2.0/vacancies/][catalogues][4]=273&1[https://api.superjob.ru/2.0/vacancies/][experience]=3&1[https://api.superjob.ru/2.0/vacancies/][resumesubscription_status]=0&1[https://api.superjob.ru/2.0/vacancies/][resumesubscription_kwc]=or&1[https://api.superjob.ru/2.0/vacancies/][resumesubscription_rws]=7&1[https://api.superjob.ru/2.0/vacancies/][phones][0][additional]=456654&1[https://api.superjob.ru/2.0/vacancies/][phones][0][country_code]=7&1[https://api.superjob.ru/2.0/vacancies/][phones][0][city_code]=495&1[https://api.superjob.ru/2.0/vacancies/][phones][0][number]=7907277&1[https://api.superjob.ru/2.0/vacancies/][languages][0][level]=5&1[https://api.superjob.ru/2.0/vacancies/][access_token]=youraccesstoken&2[https://api.superjob.ru/2.0/vacancies/][published]=0&2[https://api.superjob.ru/2.0/vacancies/][town]=4&2[https://api.superjob.ru/2.0/vacancies/][moveable]=1&2[https://api.superjob.ru/2.0/vacancies/][old1]=22&2[https://api.superjob.ru/2.0/vacancies/][old2]=99&2[https://api.superjob.ru/2.0/vacancies/][pol]=2&2[https://api.superjob.ru/2.0/vacancies/][payment_from]=27059&2[https://api.superjob.ru/2.0/vacancies/][payment_to]=139168&2[https://api.superjob.ru/2.0/vacancies/][type_of_work]=13&2[https://api.superjob.ru/2.0/vacancies/][place_of_work]=1&2[https://api.superjob.ru/2.0/vacancies/][education]=3&2[https://api.superjob.ru/2.0/vacancies/][drive_license][0]=A&2[https://api.superjob.ru/2.0/vacancies/][drive_license][1]=B&2[https://api.superjob.ru/2.0/vacancies/][drive_license][2]=C&2[https://api.superjob.ru/2.0/vacancies/][drive_license][3]=D&2[https://api.superjob.ru/2.0/vacancies/][drive_license][4]=E&2[https://api.superjob.ru/2.0/vacancies/][profession]=UI-web designer1398426283.401&2[https://api.superjob.ru/2.0/vacancies/][code]=616516&2[https://api.superjob.ru/2.0/vacancies/][work]=Дизайн и прочие обязанности&2[https://api.superjob.ru/2.0/vacancies/][compensation]=Полный соцпакет&2[https://api.superjob.ru/2.0/vacancies/][url]=www.example.ru&2[https://api.superjob.ru/2.0/vacancies/][mail]=example@mail.ru&2[https://api.superjob.ru/2.0/vacancies/][name]=ООО Вектор&2[https://api.superjob.ru/2.0/vacancies/][contact]=Иванов Иван&2[https://api.superjob.ru/2.0/vacancies/][company]=Дизайн-студия.&2[https://api.superjob.ru/2.0/vacancies/][candidat]=Верстка и создание макетов для журналов&2[https://api.superjob.ru/2.0/vacancies/][maritalstatus]=2&2[https://api.superjob.ru/2.0/vacancies/][children]=3&2[https://api.superjob.ru/2.0/vacancies/][address]=Москва, Малый переулок, д. 2&2[https://api.superjob.ru/2.0/vacancies/][refresh_vac]=1&2[https://api.superjob.ru/2.0/vacancies/][anonymous]=0&2[https://api.superjob.ru/2.0/vacancies/][metro][0]=120&2[https://api.superjob.ru/2.0/vacancies/][metro][1]=2&2[https://api.superjob.ru/2.0/vacancies/][catalogues][0]=425&2[https://api.superjob.ru/2.0/vacancies/][catalogues][1]=36&2[https://api.superjob.ru/2.0/vacancies/][catalogues][2]=37&2[https://api.superjob.ru/2.0/vacancies/][catalogues][3]=38&2[https://api.superjob.ru/2.0/vacancies/][catalogues][4]=267&2[https://api.superjob.ru/2.0/vacancies/][experience]=3&2[https://api.superjob.ru/2.0/vacancies/][resumesubscription_status]=0&2[https://api.superjob.ru/2.0/vacancies/][resumesubscription_kwc]=or&2[https://api.superjob.ru/2.0/vacancies/][resumesubscription_rws]=7&2[https://api.superjob.ru/2.0/vacancies/][phones][0][additional]=456654&2[https://api.superjob.ru/2.0/vacancies/][phones][0][country_code]=7&2[https://api.superjob.ru/2.0/vacancies/][phones][0][city_code]=495&2[https://api.superjob.ru/2.0/vacancies/][phones][0][number]=7907277&2[https://api.superjob.ru/2.0/vacancies/][languages][0][level]=5&2[https://api.superjob.ru/2.0/vacancies/][languages][0][id_language]=1&2[https://api.superjob.ru/2.0/vacancies/][access_token]=youraccesstoken
    
Ответ

Ответ приходит в виде совокупности JSON-данных, разделённым переводом строки:

{"id":10000001,"email":"example@example.ru", // .... }
    {"error":{"code":422,"message":{"catalogues":["Выберите, пожалуйста, не более 5 позиций каталога."] } } }
    {"id":26792564}

Порядок следования данных сохраняется.

Методы