Вебхуки
Укажите callbackUrl в теле запроса на отправку задачи, чтобы получать результат через вебхук вместо опроса. После завершения парсинга личный кабинет отправляет POST-запрос на этот URL с payload результата.
Отправка с callback
curl -X POST 'https://app.parsering.com/api/parsing/v1/mozilla' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d '{
"mode": "section",
"locale": "en-US",
"sectionId": "finance",
"callbackUrl": "https://my-server.com/webhook/parsing"
}'Payload вебхука
Убедитесь, что ваш эндпоинт вебхука отвечает кодом
2xxдля подтверждения получения.
Ваш эндпоинт получит POST-запрос с тем же телом, что и результат опроса, и дополнительным полем scope. Поле data имеет вид { success, data, error }:
{
"status": "ready",
"scope": "mozilla",
"requestId": "b7c1e0a4-6d29-4f83-9a15-2c8e4b6d0f31",
"data": {
"success": true,
"data": { }
},
"respondedAt": "2026-10-02T10:00:03.240Z"
}
| Поле | Тип | Описание |
|---|---|---|
| status | string | Всегда "ready" |
| scope | string | Парсер задачи: "mozilla" |
| requestId | string | ID задачи, полученный при её создании |
| data | object | Результат задачи — { success, data, error }, то же data, что в результате опроса |
| data.success | boolean | Успешно ли выполнен парсинг |
| data.data | object | Данные ленты, если data.success равен true |
| data.error | string | Сообщение об ошибке при неудачном парсинге |
| respondedAt | string | Время завершения в формате ISO 8601 |
Вебхук приходит и для успешных, и для неудачных задач — успех проверяйте по data, см. Коды ответов API. Если ваш эндпоинт не ответил кодом 2xx, запрос повторяется ещё до двух раз — через 1 и 2 секунды. Для отменённых задач и задач, завершённых по тайм-ауту, вебхук не отправляется — получите их через эндпоинт результата.
Следующие шаги
- Создание задачи — вернуться к документации по эндпоинту отправки
- Получение результата — альтернатива вебхукам через опрос