À qui s’adresse ce produit
Utilisez l’automatisation lorsque la même décision doit être exécutée dans le temps, sur une liste ou entre plusieurs produits.
Ce que vous obtenez
Placez plusieurs requêtes API compatibles en file d’attente et récupérez leurs résultats sans maintenir une connexion cliente ouverte.
AsynchroneRESTMCPSDK
Choisissez ce produit lorsque
Choisissez ce produit lorsque
À choisir pour mettre en file jusqu’à 100 requêtes GET prises en charge et récupérer des résultats JSON ou CSV pendant la fenêtre de conservation de 24 heures.
Ce que vous obtenez
Placez plusieurs requêtes API compatibles en file d’attente et récupérez leurs résultats sans maintenir une connexion cliente ouverte.
Endpoints
Examinez les opérations, entrées, sorties, modes d’exécution et limites de réponse pris en charge avant l’intégration.
Crédits et authentification
Gratuit Authentification requise. Consultez la référence de l’opération pour connaître le coût exact et les éventuels tarifs par élément.
Opération exemple
Utilisez des opérations documentées pour collecter, évaluer, enrichir, vérifier, comparer, protéger ou surveiller des preuves publiques.
POST
/v1/batches
Paramètres du Corps
| Paramètre | Type | requis |
|---|---|---|
| requests | object[] | requis |
| webhook | object | optionnel |
Champs de Réponse
| Champ | 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 |
Exemple de Requête
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"
}
}'Exemple de Réponse
{
"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 et périmètre des preuves
Les tâches asynchrones renvoient un identifiant pour interroger leur état et récupérer ensuite les résultats.
Les opérations en lot traitent plusieurs entrées prises en charge tout en conservant les résultats documentés pour chaque élément.
Partiel signifie que certains éléments ou composants demandés ont abouti et que d’autres n’ont pas abouti.
Mis en cache signifie que des preuves stockées ont été utilisées. Consultez les métadonnées de fraîcheur lorsqu’elles sont disponibles.
Vérifié le 2026-08-22
Questions fréquentes
Où trouver la référence des requêtes et réponses de Lots de requêtes API asynchrones ?
Utilisez la référence API de Lots de requêtes API asynchrones pour consulter les paramètres, les champs de réponse, les exemples, les codes d’état et les modes d’opération pris en charge.
Comment interpréter les résultats inconnus ou incomplets de Lots de requêtes API asynchrones ?
Les résultats inconnus ou partiels signifient que les preuves demandées n’ont pas pu être déterminées entièrement. Conservez l’état du résultat, le niveau de confiance, la fraîcheur et les limites dans vos décisions en aval.
Comment Lots de requêtes API asynchrones est-il tarifé ?
Le tarif dépend de l’opération et du mode d’exécution. Consultez la référence de l’endpoint pour connaître le coût actuel en crédits, l’exigence d’authentification et les règles par élément.