Для кого этот продукт
Используйте автоматизацию, когда одно решение нужно выполнять во времени, для списка или нескольких продуктов.
Что вы получите
Ставьте в очередь множество поддерживаемых запросов API и получайте результаты, не удерживая клиентское соединение открытым.
АсинхронныйRESTMCPSDK
Выберите этот продукт, если
Выберите этот продукт, если
Выбирайте для постановки в очередь до 100 поддерживаемых GET-запросов и получения JSON или CSV в течение 24 часов хранения.
Что вы получите
Ставьте в очередь множество поддерживаемых запросов API и получайте результаты, не удерживая клиентское соединение открытым.
Конечные точки
Перед интеграцией изучите поддерживаемые операции, входные и выходные данные, режимы выполнения и ограничения ответа.
Кредиты и аутентификация
Бесплатно Требуется аутентификация. Точную стоимость и правила оплаты каждого элемента см. в справочнике операции.
Пример операции
Используйте документированные операции для сбора, оценки, обогащения, проверки, сравнения, защиты или мониторинга открытых данных.
POST
/v1/batches
Параметры тела запроса
| Параметр | Тип | обязателен |
|---|---|---|
| requests | object[] | обязателен |
| webhook | object | опционально |
Поля ответа
| Поле | Тип |
|---|---|
job |
object |
job.id |
string |
job.status |
string |
job.total |
integer |
job.counts |
object |
job.counts.pending |
integer |
job.counts.processing |
integer |
job.counts.succeeded |
integer |
job.counts.failed |
integer |
job.counts.cancelled |
integer |
job.billing |
object |
job.billing.credits_charged |
integer |
job.billing.credits_refunded |
integer |
job.billing.credits_net |
integer |
job.webhook |
object |
job.webhook.configured |
boolean |
job.webhook.status |
string |
job.webhook.attempts |
integer |
job.status_url |
string |
job.results_url |
string |
job.results_csv_url |
string |
job.poll_after_ms |
integer | null |
job.created_at |
string |
job.started_at |
string | null |
job.completed_at |
string | null |
job.cancelled_at |
string | null |
job.updated_at |
string |
job.processing_deadline_at |
string |
job.results_expires_at |
string |
Пример запроса
curl -X POST "https://domscan.net/v1/batches" \
-H "Content-Type: application/json" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-d '{
"requests": [
{
"path": "/v1/status",
"query": {
"domain": "example.com"
},
"reference": "customer-42"
},
{
"path": "/v1/dns",
"query": {
"domain": "example.org",
"type": "MX"
}
}
],
"webhook": {
"url": "https://example.com/hooks/domscan",
"secret": "replace-with-a-private-secret"
}
}'Пример ответа
{
"job": {
"id": "string",
"status": "queued",
"total": 1,
"counts": {
"pending": 1,
"processing": 1,
"succeeded": 1,
"failed": 1,
"cancelled": 1
},
"billing": {
"credits_charged": 1,
"credits_refunded": 1,
"credits_net": 1
},
"webhook": {
"configured": true,
"status": "not_configured",
"attempts": 1
},
"status_url": "https://example.com",
"results_url": "https://example.com",
"results_csv_url": "https://example.com",
"poll_after_ms": 1,
"created_at": "2026-04-15T12:00:00Z",
"started_at": "2026-04-15T12:00:00Z",
"completed_at": "2026-04-15T12:00:00Z",
"cancelled_at": "2026-04-15T12:00:00Z",
"updated_at": "2026-04-15T12:00:00Z",
"processing_deadline_at": "2026-04-15T12:00:00Z",
"results_expires_at": "2026-04-15T12:00:00Z"
}
}Ограничения и границы доказательств
Асинхронные задачи возвращают идентификатор для опроса состояния и последующего получения результатов.
Пакетные операции обрабатывают несколько входных данных, сохраняя документированные результаты по каждому элементу.
Частичный результат означает, что часть элементов или компонентов выполнена, а часть нет.
Кэшированный результат использует сохранённые данные; при наличии проверяйте сведения об актуальности.
Проверено 2026-08-22
Часто задаваемые вопросы
Где найти справочник запросов и ответов для Асинхронные пакетные запросы API?
В справочнике API для Асинхронные пакетные запросы API описаны параметры, поля ответа, примеры, коды состояния и поддерживаемые режимы выполнения.
Как интерпретировать неизвестные или неполные результаты Асинхронные пакетные запросы API?
Неизвестный или частичный результат означает, что запрошенные данные не удалось определить полностью. Учитывайте состояние результата, уверенность, актуальность и ограничения при дальнейших решениях.
Как рассчитывается цена Асинхронные пакетные запросы API?
Цена зависит от операции и режима выполнения. Текущую стоимость кредита, требования к аутентификации и правила оплаты каждого элемента см. в справочнике операции.