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

Подключение webhooks

Для подключения webhook необходимо связаться с технической поддержкой нашего сервиса и передать url, на который будут приходить сообщения.

Все сообщения передаются на webhook методом POST.

Данные поступают на webhook в течение 15 минут после события.

Webhook для получения события изменения статуса объявления.

Данное событие происходит в момент изменения статуса объявления в сервисе  Jcat. 

Возможные значения статусы. Список приведён в последовательности, которая характерна вакансиям в сервисе Jcat:

  1. Ожидает модерации (on_moderation)

  2. Модерация не пройдена (moderation_error)  – может отсутствовать

  3. Размещено на сайтах (published)

  4. Размещено на сайтах (есть ошибки) (published_error) – может отсутствовать

  5. Размещение на сайтах завершено (completed)

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

  1. Модерация не пройдена — ошибки будут содержаться в теле ответа

  2. Размещено на сайтах (есть ошибки) — необходимо обратиться в API Jcat для получения более подробной информации GET /v1/orders/{id}/errors (документация: https://www.jcat.ru/job_vacancy/api-doc/stats/раздел «Получение списка ошибок при размещении вакансии»)

Пример передаваемых данных:

{
    "order_id": Идентификатор объявления в сервисе Jcat
    "user_order_id": Идентификатор объявление в сервисе клиента (при заполнении поля "ID вакансии"),
    "status": "published",

}

 Пример передаваемых данных при статусе «Модерация не пройдена»:

{
    "order_id": Идентификатор объявления в сервисе Jcat
    "user_order_id": Идентификатор объявление в сервисе клиента (при заполнении поля "ID вакансии"),
    "status": "moderation_error",
    "data": {
        "fields": [
            {
                "name": Имя поля из API-документации https://www.jcat.ru/job_vacancy/api-doc/order-create/ для создания вакансии,
                "title": Название поле на форме подачи объявления Jcat,
                "errors": ["Текст ошибки", "Текст ошибки"]
            },
            ..
        ]
    }
}