Voor wie is dit?
Gebruik automatisering wanneer dezelfde beslissing door de tijd heen, voor een lijst of over meerdere producten moet worden uitgevoerd.
Wat je krijgt
Plaats meerdere ondersteunde API-verzoeken in de wachtrij en verzamel de resultaten zonder een clientverbinding open te houden.
AsynchroonRESTMCPSDK
Kies dit product wanneer
Kies dit product wanneer
Kies dit om maximaal 100 ondersteunde GET-verzoeken in de wachtrij te zetten en JSON- of CSV-resultaten binnen het bewaarvenster van 24 uur op te halen.
Wat je krijgt
Plaats meerdere ondersteunde API-verzoeken in de wachtrij en verzamel de resultaten zonder een clientverbinding open te houden.
Endpoints
Bekijk vóór de integratie de ondersteunde bewerkingen, invoer, uitvoer, uitvoeringsmodi en responslimieten.
Credits en authenticatie
Gratis Authenticatie vereist. Bekijk de bewerkingsreferentie voor de exacte kosten en eventuele prijs per item.
Voorbeeldbewerking
Gebruik gedocumenteerde bewerkingen om openbaar bewijs te verzamelen, te beoordelen, te verrijken, te verifiëren, te vergelijken, te beschermen of te monitoren.
POST
/v1/batches
Lichaamsparameters
| Parameter | Type | vereist |
|---|---|---|
| requests | object[] | vereist |
| webhook | object | optioneel |
Antwoordvelden
| Veld | Type |
|---|---|
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 |
Voorbeeldverzoek
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"
}
}'Voorbeeldantwoord
{
"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"
}
}Beperkingen en grenzen van het bewijs
Asynchrone jobs geven een identifier terug voor statuspolling en het later ophalen van resultaten.
Bulkbewerkingen verwerken meerdere ondersteunde inputs en behouden de gedocumenteerde resultaten per item.
Gedeeltelijk betekent dat sommige gevraagde items of onderdelen zijn voltooid en andere niet.
In cache geeft aan dat opgeslagen bewijs is gebruikt. Bekijk de metadata voor actualiteit wanneer die beschikbaar is.
Beoordeeld op 2026-08-22
Veelgestelde vragen
Waar vind ik de request- en response-referentie voor Asynchrone API-batches?
Gebruik de API-referentie voor Asynchrone API-batches om parameters, responsevelden, voorbeelden, statuscodes en ondersteunde uitvoeringsmodi te bekijken.
Hoe moet ik onbekende of onvolledige resultaten van Asynchrone API-batches interpreteren?
Onbekende of gedeeltelijke resultaten betekenen dat het gevraagde bewijs niet volledig kon worden vastgesteld. Houd de resultaatstatus, betrouwbaarheid, actualiteit en beperkingen bij in vervolgbeslissingen.
Hoe wordt Asynchrone API-batches geprijsd?
De prijs hangt af van de bewerking en uitvoeringsmodus. Bekijk de endpointreferentie voor de actuele creditkosten, authenticatievereiste en regels per item.