Документация API JCat.Работа

Компании-работодатели

Создание компании

POST /v1/employers/

Принимаемые параметры:

ИмяТипОбязательноеОписание
nameСтрокаДаНаименование компании
tinЧисловое значениеДаИНН компании
reasonCodeЧисловое значениеНетКПП компании
descriptionТекстДаОписание компании
url
Строка
Нет
Ссылка на сайт компании
phone
Числовое значение
ДаТелефон компании. Формат - 7XXXXXXXXXX
additionalPhone
Числовое значение
ДаДополнительный телефон компании. Формат - 7XXXXXXXXXX
email
Строка
ДаEmail компании
logo
Файл
ДаФайл с изображением логотипа компании в бинарном формате

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

  • 201 OK- успешное выполнение
  • 400 Error - ошибка валидации
  • 403 Forbidden - доступ к разделу ограничен

Дополнительные параметры:

id - Идентификатор созданной компании в сервисе Jcat

isApproved - Одобрение компании модераторами Jcat. true - одобрена, false - не одобрена

logo - Данные по загруженной картинки в качестве логотипа

packetOrders - Массив пакетов объявлений, которые связаны с компанией

vacancyOrders - Массив вакансий, которые привязаны к компании

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

{
    "data": {
        "id": 41741,
        "name": "ООО Компания",
        "title": "Компания",
        "tin": "7713748560",
        "reasonCode": "920401001",
        "isApproved": false,
        "description": "123",
        "url": "https:\/\/www.jcat.ru",
        "phone": "79999999999",
        "additionalPhone": "",
        "email": "qwerty@mail.ru",
        "logo": {
            "id": 6421,
            "ext": "jpeg",
            "filename": "photo_2020-06-26_11-25-16.jpg",
            "filetype": "image\/jpeg",
            "filesize": 159941,
            "pathname": "\/images\/employers\/2020-07\/10\/62c6721797bfda44d22259c2798205d2.jpeg",
            "download_date": "2020-07-10T16:19:52+03:00",
            "width": 960,
            "height": 1280,
            "hash": "d5ec8fa53cb0c5f637e491d99fd19efa",
            "preview": "\/images\/employers\/2020-07\/10\/62c6721797bfda44d22259c2798205d2.jpeg",
        },
        "packetOrders": [
          {
             "id": 21564,
             "title": "Публикация вакансий - 10",
             "createdAt": "2018-08-17T00:55:34+03:00",
             "number": "P21564"
          }, 
          ..
        ],
        "vacancyOrders": [
           {
              "id": 1091459
           },
           ..
        ]
    }
}

Редактирование компании

PUT /v1/employers/{id}/

Обязательные параметры:

ИмяТипОписание
idЧисловое значение
Идентификатор компании в сервисе Jcat

Параметры тела запроса

Параметры и их формат совпадают с указанными в разделе создания компании

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

  • 200 OK - успешное выполнение
  • 403 Forbidden - доступ к разделу и/или плательщику ограничен
  • 404 Not Found - плательщик не существует

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

{
    "data": {
        "id": 41741,
        "name": "ООО Компания",
        "title": "Компания",
        "tin": "7713748560",
        "reasonCode": "920401001",
        "isApproved": false,
        "description": "123",
        "url": "https:\/\/www.jcat.ru",
        "phone": "79999999999",
        "additionalPhone": "",
        "email": "qwerty@mail.ru",
        "logo": {
            "id": 6421,
            "ext": "jpeg",
            "filename": "photo_2020-06-26_11-25-16.jpg",
            "filetype": "image\/jpeg",
            "filesize": 159941,
            "pathname": "\/images\/employers\/2020-07\/10\/62c6721797bfda44d22259c2798205d2.jpeg",
            "download_date": "2020-07-10T16:19:52+03:00",
            "width": 960,
            "height": 1280,
            "hash": "d5ec8fa53cb0c5f637e491d99fd19efa",
            "preview": "\/images\/employers\/2020-07\/10\/62c6721797bfda44d22259c2798205d2.jpeg",
        },
        "packetOrders": [
          {
             "id": 21564,
             "title": "Публикация вакансий - 10",
             "createdAt": "2018-08-17T00:55:34+03:00",
             "number": "P21564"
          }, 
          ..
        ],
        "vacancyOrders": [
           {
              "id": 1091459
           },
           ..
        ]
    }
}

Список компаний

GET /v1/employers/list/{page}/{limit}/

Обязательные параметры:

ИмяТипОписание
page
Числовое значение
Страница пагинации
limit
Числовое значение
Количество компаний на странице (максимум: 1000)


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

  • 200 OK - успешное выполнение
  • 403 Forbidden - доступ к разделу  ограничен

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

{
    "data": [
    "items": [
    {
        "id": 41741,
        "name": "ООО Компания",
        "title": "Компания",
        "tin": "7713748560",
        "reasonCode": "920401001",
        "isApproved": false,
        "description": "123",
        "url": "https:\/\/www.jcat.ru",
        "phone": "79999999999",
        "additionalPhone": "",
        "email": "qwerty@mail.ru",
        "logo": {
            "id": 6421,
            "ext": "jpeg",
            "filename": "photo_2020-06-26_11-25-16.jpg",
            "filetype": "image\/jpeg",
            "filesize": 159941,
            "pathname": "\/images\/employers\/2020-07\/10\/62c6721797bfda44d22259c2798205d2.jpeg",
            "download_date": "2020-07-10T16:19:52+03:00",
            "width": 960,
            "height": 1280,
            "hash": "d5ec8fa53cb0c5f637e491d99fd19efa",
            "preview": "\/images\/employers\/2020-07\/10\/62c6721797bfda44d22259c2798205d2.jpeg",
        },
        "packetOrders": [],
        "vacancyOrders": []
    },
    {
    // Следующая компания в списке
    },
    ..
    ],
    "total": 38 // Количество компаний
    "pages": {
            "page": 3, // Текущая страница
            "total": 19, // Количество страниц
            "limit": 2 // Количество элементов на странице
        }
    ]
}