A chi è rivolto
Usa l’automazione quando la stessa decisione deve essere eseguita nel tempo, su un elenco o tra più prodotti.
Cosa ottieni
Accoda più richieste API supportate e raccogli i risultati senza mantenere aperta una connessione client.
AsincronaRESTMCPSDK
Scegli questo prodotto quando
Scegli questo prodotto quando
Sceglilo per accodare fino a 100 richieste GET supportate e recuperare risultati JSON o CSV entro la finestra di conservazione di 24 ore.
Cosa ottieni
Accoda più richieste API supportate e raccogli i risultati senza mantenere aperta una connessione client.
Endpoint
Esamina le operazioni, gli input, gli output, le modalità di esecuzione e i limiti di risposta supportati prima dell’integrazione.
Crediti e autenticazione
Gratis Autenticazione richiesta. Consulta il riferimento dell’operazione per il costo esatto e gli eventuali prezzi per elemento.
Operazione di esempio
Usa operazioni documentate per raccogliere, valutare, arricchire, verificare, confrontare, proteggere o monitorare prove pubbliche.
POST
/v1/batches
Parametri del corpo
| Parametro | Tipo | obbligatorio |
|---|---|---|
| requests | object[] | obbligatorio |
| webhook | object | facoltativo |
Campi di risposta
| 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 |
Richiesta di esempio
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"
}
}'Risposta di esempio
{
"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"
}
}Limiti e confini delle prove
I job asincroni restituiscono un identificatore per interrogare lo stato e recuperare in seguito i risultati.
Le operazioni bulk elaborano più input supportati mantenendo gli esiti documentati per ogni elemento.
Parziale significa che alcuni elementi o componenti richiesti sono stati completati e altri no.
In cache indica che sono state usate prove archiviate. Esamina i metadati di aggiornamento quando disponibili.
Verificato il 2026-08-22
Domande frequenti
Dove posso trovare il riferimento di richiesta e risposta di Batch API asincroni?
Usa il riferimento API di Batch API asincroni per esaminare parametri, campi di risposta, esempi, codici di stato e modalità operative supportate.
Come devo interpretare i risultati sconosciuti o incompleti di Batch API asincroni?
I risultati sconosciuti o parziali indicano che le prove richieste non hanno potuto essere determinate completamente. Conserva stato del risultato, confidenza, aggiornamento e limiti nelle decisioni successive.
Come viene tariffato Batch API asincroni?
Il prezzo dipende dall’operazione e dalla modalità di esecuzione. Consulta il riferimento dell’endpoint per il costo attuale in crediti, il requisito di autenticazione e le regole per elemento.