Для подключения webhook необходимо связаться с технической поддержкой нашего сервиса и передать url, на который будут приходить сообщения.
Все сообщения передаются на webhook методом POST
.
Данные поступают на webhook в течение 15 минут после события.
Webhook для получения события изменения статуса объявления.
Данное событие происходит в момент изменения статуса объявления в сервисе Jcat.
Возможные значения статусы. Список приведён в последовательности, которая характерна вакансиям в сервисе Jcat:
Ожидает модерации (on_moderation)
Модерация не пройдена (moderation_error) – может отсутствовать
Размещено на сайтах (published)
Размещено на сайтах (есть ошибки) (published_error) – может отсутствовать
Размещение на сайтах завершено (completed)
Для некоторых статусов существует возможность получение дополнительной информации по объявлению:
Модерация не пройдена — ошибки будут содержаться в теле ответа
Размещено на сайтах (есть ошибки) — необходимо обратиться в 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": ["Текст ошибки", "Текст ошибки"] }, ..
] } }