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

Zobacz, co każdy endpoint przyjmuje i zwraca, jakie ma tryby i limity, zanim zaczniesz integrację.

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
GET /v1/jobs/:job_id Otwórz referencję API
GET /v1/jobs/:job_id/results Otwórz referencję API
POST /v1/jobs/:job_id/cancel Otwórz referencję API
POST /v1/estimate Otwórz referencję API
POST /v1/feedback Otwórz referencję API

Kredyty i uwierzytelnianie

Bezpłatnie Wymagane uwierzytelnianie. Dokładny koszt, w tym ewentualne ceny za element, znajdziesz w dokumentacji API.

Przykładowa operacja

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

POST /v1/batches Kredyty: 0

Parametry treści

Parametr Typ wymagane
notify_webhook unknown opcjonalne
requests object[] wymagane
webhook object opcjonalne

Pola odpowiedzi

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ładowe żądanie

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"
  }
}'
const response = await fetch("https://domscan.net/v1/batches", {
  method: "POST",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "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"
    }
  }),
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.post(
    "https://domscan.net/v1/batches",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={
        "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",
        },
    },
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)

func main() {
	body := strings.NewReader(`{
	  "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"
	  }
	}`)
	req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/batches", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/batches")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
  "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"
  }
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Przykładowa odpowiedź

{
  "job": {
    "id": "example-id",
    "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": false,
      "status": "not_configured",
      "attempts": 1
    },
    "status_url": "https://example.com",
    "results_url": "https://example.com",
    "results_csv_url": "https://example.com",
    "created_at": "2026-08-27T12:00:00Z",
    "updated_at": "2026-08-27T12:00:00Z",
    "processing_deadline_at": "2026-08-27T12:00:00Z",
    "results_expires_at": "2026-08-27T12:00:00Z",
    "poll_after_ms": 1,
    "started_at": "2026-08-27T12:00:00Z",
    "completed_at": "2026-08-27T12:00:00Z",
    "cancelled_at": "2026-08-27T12:00:00Z"
  }
}

Kody statusu HTTP

  • 200 OK
  • 202 Przyjęto
  • 400 Nieprawidłowe żądanie
  • 401 Nieautoryzowany
  • 402 Wymagana płatność
  • 409 HTTP 409
  • 429 Zbyt wiele żądań

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?

Wynik nieznany lub częściowy oznacza, że nie udało się go w pełni potwierdzić. Uwzględnij status, pewność, aktualność i wszelkie limity, zanim na jego podstawie zadziałasz.

Jak wyceniany jest Asynchroniczne partie żądań API?

Cena zależy od sprawdzenia i wybranego trybu. Dokumentacja API pokazuje aktualny koszt w kredytach, informację, czy potrzebujesz klucza API, oraz ewentualne ceny za element.

Używany przez ludzi w tych firmach

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse