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

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

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

POST /v1/employers/

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

ИмяТипОбязательноеОписание
nameСтрокаДаНаименование компании
title
Строка
Да
Наименование компании для отображении на работных сайтах
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 // Количество элементов на странице
        }
    ]
}

Удаление компании

DELETE /v1/employers/{id}/

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

ИмяТипОписание
 id integerИдентификатор компании

Пояснения:

Возможно удаление только компаний, которые не имеют привязки к вакансиям

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

  • 204 OK - успешное удаление
  • 404 Not Found - комапния не найдена
  • 403 Forbidden - страница недоступна данному пользователю
  • 400 Bad Request - ошибка при удалении компании