Überwachung und Automatisierung · DomScan-Produkt

API für Asynchrone API-Stapel

Stellen Sie mehrere unterstützte API-Anfragen in eine Warteschlange und rufen Sie die Ergebnisse ab, ohne eine Clientverbindung offen zu halten.

Was Sie erhalten

Stellen Sie mehrere unterstützte API-Anfragen in eine Warteschlange und rufen Sie die Ergebnisse ab, ohne eine Clientverbindung offen zu halten.

AsynchronRESTMCPSDK

Wählen Sie dieses Produkt, wenn

Für wen es gedacht ist

Nutzen Sie Automatisierung, wenn dieselbe Entscheidung über die Zeit, über eine Liste oder über mehrere Produkte hinweg ausgeführt werden muss.

Wählen Sie dieses Produkt, wenn

Wählen Sie dies, um bis zu 100 unterstützte GET-Anfragen einzureihen und JSON- oder CSV-Ergebnisse innerhalb der 24-stündigen Aufbewahrung abzurufen.

Was Sie erhalten

Stellen Sie mehrere unterstützte API-Anfragen in eine Warteschlange und rufen Sie die Ergebnisse ab, ohne eine Clientverbindung offen zu halten.

Endpunkte

Prüfen Sie vor der Integration die unterstützten Operationen, Eingaben, Ausgaben, Ausführungsmodi und Antwortlimits.

POST /v1/batches API-Referenz ansehen
GET /v1/batches API-Referenz ansehen
GET /v1/batches/:job_id API-Referenz ansehen
GET /v1/batches/:job_id/results API-Referenz ansehen
DELETE /v1/batches/:job_id API-Referenz ansehen

Credits und Authentifizierung

Kostenlos Authentifizierung erforderlich. Die genaue Gebühr und mögliche Preise pro Element finden Sie in der Operationsreferenz.

Beispieloperation

Nutzen Sie dokumentierte Operationen, um öffentliche Belege zu erfassen, zu bewerten, anzureichern, zu verifizieren, zu vergleichen, zu schützen oder zu überwachen.

POST /v1/batches

Body-Parameter

Parameter Typ erforderlich
requests object[] erforderlich
webhook object optional

Antwort-Felder

Feld Typ
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

Beispielanfrage

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"
  }
}'

Beispielantwort

{
  "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"
  }
}

Limits und Grenzen der Beweislage

Asynchrone Jobs liefern eine Kennung für Statusabfragen und den späteren Abruf der Ergebnisse.
Bulk-Operationen verarbeiten mehrere unterstützte Eingaben und bewahren die dokumentierten Ergebnisse pro Element.
Teilweise bedeutet, dass einige angeforderte Elemente oder Komponenten abgeschlossen wurden und andere nicht.
Aus dem Cache bedeutet, dass gespeicherte Belege verwendet wurden. Prüfen Sie die Aktualitätsmetadaten, sofern vorhanden.

Geprüft am 2026-08-22

Häufig gestellte Fragen

Wo finde ich die Request- und Response-Referenz für Asynchrone API-Stapel?

In der API-Referenz für Asynchrone API-Stapel finden Sie Parameter, Response-Felder, Beispiele, Statuscodes und unterstützte Operationsmodi.

Wie sollte ich unbekannte oder unvollständige Ergebnisse von Asynchrone API-Stapel interpretieren?

Unbekannte oder teilweise Ergebnisse bedeuten, dass die angeforderten Belege nicht vollständig bestimmt werden konnten. Berücksichtigen Sie Ergebnisstatus, Konfidenz, Aktualität und Einschränkungen in nachgelagerten Entscheidungen.

Wie wird Asynchrone API-Stapel abgerechnet?

Die Abrechnung hängt von Operation und Ausführungsmodus ab. Die Endpoint-Referenz nennt die aktuellen Credit-Kosten, die Authentifizierungsanforderung und die Regeln pro Element.