Para quem é
Use automação quando a mesma decisão precisar ser executada ao longo do tempo, em uma lista ou entre vários produtos.
O que você recebe
Coloque várias requisições compatíveis da API na fila e colete os resultados sem manter uma conexão do cliente aberta.
AssíncronoRESTMCPSDK
Escolha este produto quando
Escolha este produto quando
Escolha para enfileirar até 100 GETs compatíveis e obter resultados JSON ou CSV dentro da retenção de 24 horas.
O que você recebe
Coloque várias requisições compatíveis da API na fila e colete os resultados sem manter uma conexão do cliente aberta.
Endpoints
Revise as operações, entradas, saídas, modos de execução e limites de resposta compatíveis antes da integração.
Créditos e autenticação
Grátis Autenticação obrigatória. Consulte a referência da operação para ver o custo exato e qualquer preço por item.
Operação de exemplo
Use operações documentadas para coletar, avaliar, enriquecer, verificar, comparar, proteger ou monitorar evidências públicas.
POST
/v1/batches
Parâmetros do Corpo
| Parâmetro | Tipo | obrigatório |
|---|---|---|
| requests | object[] | obrigatório |
| webhook | object | opcional |
Campos de Resposta
| Campo | Tipo |
|---|---|
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 |
Pedido de Exemplo
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"
}
}'Resposta de Exemplo
{
"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"
}
}Limites e fronteiras das evidências
Tarefas assíncronas retornam um identificador para consulta de status e recuperação posterior dos resultados.
Operações em lote processam várias entradas compatíveis e preservam os resultados documentados por item.
Parcial significa que alguns itens ou componentes solicitados foram concluídos, mas outros não.
Em cache indica que evidências armazenadas foram usadas. Consulte os metadados de atualização quando disponíveis.
Revisado em 2026-08-22
Perguntas frequentes
Onde encontro a referência de solicitação e resposta de Lotes assíncronos de API?
Use a referência da API de Lotes assíncronos de API para revisar parâmetros, campos de resposta, exemplos, códigos de status e modos de operação compatíveis.
Como devo interpretar resultados desconhecidos ou incompletos de Lotes assíncronos de API?
Resultados desconhecidos ou parciais significam que as evidências solicitadas não puderam ser totalmente determinadas. Mantenha o estado do resultado, a confiança, a atualização e as limitações nas decisões seguintes.
Como Lotes assíncronos de API é cobrado?
O preço depende da operação e do modo de execução. Consulte a referência do endpoint para ver o custo atual em créditos, o requisito de autenticação e as regras por item.