Para quién es
Usa la automatización cuando la misma decisión deba ejecutarse a lo largo del tiempo, sobre una lista o entre varios productos.
Qué obtienes
Pon en cola varias solicitudes compatibles de la API y recopila sus resultados sin mantener abierta una conexión del cliente.
AsíncronoRESTMCPSDK
Elige este producto cuando
Elige este producto cuando
Elige esto para encolar hasta 100 solicitudes GET compatibles y obtener resultados JSON o CSV durante el periodo de conservación de 24 horas.
Qué obtienes
Pon en cola varias solicitudes compatibles de la API y recopila sus resultados sin mantener abierta una conexión del cliente.
Endpoints
Revisa las operaciones, entradas, salidas, modos de ejecución y límites de respuesta compatibles antes de integrar.
Créditos y autenticación
Gratis Autenticación obligatoria. Consulta la referencia de la operación para conocer el coste exacto y cualquier precio por elemento.
Operación de ejemplo
Usa operaciones documentadas para recopilar, evaluar, enriquecer, verificar, comparar, proteger o monitorizar evidencias públicas.
POST
/v1/batches
Parámetros del cuerpo
| Parámetro | Tipo | obligatorio |
|---|---|---|
| requests | object[] | obligatorio |
| webhook | object | opcional |
Campos de respuesta
| 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 |
Solicitud de ejemplo
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"
}
}'Respuesta de ejemplo
{
"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"
}
}Límites y alcance de la evidencia
Los trabajos asíncronos devuelven un identificador para consultar el estado y recuperar los resultados más adelante.
Las operaciones masivas procesan varias entradas compatibles y conservan los resultados documentados para cada elemento.
Parcial significa que algunos elementos o componentes solicitados se completaron y otros no.
En caché indica que se usó evidencia almacenada. Revisa los metadatos de vigencia cuando estén disponibles.
Revisado el 2026-08-22
Preguntas frecuentes
¿Dónde puedo encontrar la referencia de solicitud y respuesta de Lotes asíncronos de API?
Usa la referencia de API de Lotes asíncronos de API para revisar parámetros, campos de respuesta, ejemplos, códigos de estado y modos de operación compatibles.
¿Cómo debo interpretar los resultados desconocidos o incompletos de Lotes asíncronos de API?
Los resultados desconocidos o parciales indican que la evidencia solicitada no pudo determinarse por completo. Conserva el estado del resultado, la confianza, la vigencia y las limitaciones en las decisiones posteriores.
¿Cómo se calcula el precio de Lotes asíncronos de API?
El precio depende de la operación y del modo de ejecución. Consulta la referencia del endpoint para conocer el coste actual en créditos, el requisito de autenticación y las reglas por elemento.