Документация 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 - ошибка при удалении компании