İzleme ve Otomasyon · DomScan ürünü

Eşzamansız API grupları API ürünü

İstemci bağlantısını açık tutmadan birçok desteklenen API isteğini kuyruğa alın ve sonuçlarını toplayın.

Elde edecekleriniz

İstemci bağlantısını açık tutmadan birçok desteklenen API isteğini kuyruğa alın ve sonuçlarını toplayın.

AsenkronRESTMCPSDK

Bu ürünü şu durumlarda seçin

Kimler için

Aynı kararın zaman içinde, bir listede veya birden fazla üründe çalıştırılması gerektiğinde otomasyonu kullanın.

Bu ürünü şu durumlarda seçin

100’e kadar desteklenen GET isteğini kuyruğa almak ve 24 saatlik saklama süresinde JSON veya CSV sonuçları almak için seçin.

Elde edecekleriniz

İstemci bağlantısını açık tutmadan birçok desteklenen API isteğini kuyruğa alın ve sonuçlarını toplayın.

Uç noktalar

Entegrasyondan önce desteklenen işlemleri, girdileri, çıktıları, yürütme modlarını ve yanıt sınırlarını inceleyin.

GET /v1/batches/:job_id API referansını görüntüle
GET /v1/batches/:job_id/results API referansını görüntüle
DELETE /v1/batches/:job_id API referansını görüntüle

Krediler ve kimlik doğrulama

Ücretsiz Kimlik doğrulama gerekli. Kesin maliyet ve öğe başına fiyatlandırma kuralları için işlem referansına bakın.

İşlem örneği

Herkese açık kanıtları toplamak, değerlendirmek, zenginleştirmek, doğrulamak, karşılaştırmak, korumak veya izlemek için belgelenmiş işlemleri kullanın.

POST /v1/batches

Gövde Parametreleri

Parametre Tür gerekli
requests object[] gerekli
webhook object isteğe bağlı

Yanıt Alanları

Alan Tür
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

Örnek İstek

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

Örnek Yanıt

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

Sınırlar ve kanıt kapsamı

Asenkron işler, durumu sorgulamak ve sonuçları daha sonra almak için bir tanımlayıcı döndürür.
Toplu işlemler birden çok desteklenen girdiyi işler ve belgelenen öğe düzeyi sonuçlarını korur.
Kısmi, istenen öğelerin veya bileşenlerin yalnızca bir bölümünün tamamlandığı anlamına gelir.
Önbellekli, saklanan kanıtların kullanıldığını belirtir; varsa güncellik bilgilerini inceleyin.

2026-08-22 tarihinde incelendi

Sık sorulan sorular

Eşzamansız API grupları istek ve yanıt referansını nerede bulabilirim?

Parametreleri, yanıt alanlarını, örnekleri, durum kodlarını ve desteklenen yürütme modlarını incelemek için Eşzamansız API grupları API referansını kullanın.

Eşzamansız API grupları kaynaklı bilinmeyen veya eksik sonuçları nasıl yorumlamalıyım?

Bilinmeyen veya kısmi sonuçlar, istenen kanıtın tamamen belirlenemediği anlamına gelir. Sonraki kararlarda sonuç durumunu, güveni, güncelliği ve sınırları koruyun.

Eşzamansız API grupları nasıl fiyatlandırılır?

Fiyatlandırma işleme ve yürütme moduna bağlıdır. Güncel kredi maliyeti, kimlik doğrulama gereksinimi ve öğe başına kurallar için uç nokta referansına bakın.