Monitorowanie i automatyzacja · Produkt DomScan

API Asynchroniczne partie żądań API

Dodawaj wiele obsługiwanych żądań API do kolejki i odbieraj ich wyniki bez utrzymywania otwartego połączenia klienta.

Co otrzymasz

Dodawaj wiele obsługiwanych żądań API do kolejki i odbieraj ich wyniki bez utrzymywania otwartego połączenia klienta.

AsynchronicznyRESTMCPSDK

Wybierz ten produkt, gdy

Dla kogo jest ten produkt

Używaj automatyzacji, gdy ta sama decyzja musi być wykonywana w czasie, dla listy lub kilku produktów.

Wybierz ten produkt, gdy

Wybierz, aby kolejkować do 100 obsługiwanych żądań GET i pobierać wyniki JSON lub CSV w 24-godzinnym oknie przechowywania.

Co otrzymasz

Dodawaj wiele obsługiwanych żądań API do kolejki i odbieraj ich wyniki bez utrzymywania otwartego połączenia klienta.

Endpointy

Przed integracją sprawdź obsługiwane operacje, dane wejściowe i wyjściowe, tryby wykonania oraz limity odpowiedzi.

POST /v1/batches Otwórz referencję API
GET /v1/batches Otwórz referencję API
GET /v1/batches/:job_id Otwórz referencję API
GET /v1/batches/:job_id/results Otwórz referencję API
DELETE /v1/batches/:job_id Otwórz referencję API

Kredyty i uwierzytelnianie

Bezpłatnie Wymagane uwierzytelnianie. Dokładny koszt i zasady opłat za element sprawdź w referencji operacji.

Przykładowa operacja

Korzystaj z udokumentowanych operacji, aby zbierać, oceniać, wzbogacać, weryfikować, porównywać, chronić lub monitorować publiczne dane.

POST /v1/batches

Parametry treści

Parametr Typ wymagane
requests object[] wymagane
webhook object opcjonalne

Odpowiedź Fields

Pole 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

Przykład Request

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

Example Odpowiedź

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

Limity i granice dowodów

Zadania asynchroniczne zwracają identyfikator do odpytywania o stan i późniejszego pobrania wyników.
Operacje zbiorcze przetwarzają wiele obsługiwanych danych wejściowych, zachowując udokumentowane wyniki dla poszczególnych elementów.
Częściowy wynik oznacza, że wykonano tylko część żądanych elementów lub komponentów.
Wynik z pamięci podręcznej korzysta z zapisanych dowodów; jeśli są dostępne, sprawdź dane o aktualności.

Sprawdzono 2026-08-22

Często zadawane pytania

Gdzie znajdę referencję żądań i odpowiedzi dla Asynchroniczne partie żądań API?

W referencji API dla Asynchroniczne partie żądań API znajdziesz parametry, pola odpowiedzi, przykłady, kody stanu i obsługiwane tryby wykonania.

Jak interpretować nieznane lub niepełne wyniki Asynchroniczne partie żądań API?

Nieznany lub częściowy wynik oznacza, że nie udało się w pełni określić żądanych dowodów. W dalszych decyzjach zachowaj stan wyniku, poziom pewności, aktualność i ograniczenia.

Jak wyceniany jest Asynchroniczne partie żądań API?

Cena zależy od operacji i trybu wykonania. Bieżący koszt kredytowy, wymagania uwierzytelniania i zasady opłat za element sprawdź w referencji endpointu.