المراقبة والأتمتة · منتج DomScan

API الخاص بـ دفعات API غير المتزامنة

ضع العديد من طلبات API المدعومة في قائمة انتظار واجمع نتائجها من دون إبقاء اتصال العميل مفتوحاً.

ما الذي تحصل عليه

ضع العديد من طلبات API المدعومة في قائمة انتظار واجمع نتائجها من دون إبقاء اتصال العميل مفتوحاً.

غير متزامنRESTMCPSDK

اختر هذا المنتج عندما

لمن صُمم هذا المنتج

استخدم الأتمتة عندما يجب تنفيذ القرار نفسه عبر الزمن أو على قائمة أو عبر عدة منتجات.

اختر هذا المنتج عندما

اختره لوضع ما يصل إلى 100 طلب GET مدعوم في قائمة الانتظار واسترداد النتائج بصيغة JSON أو CSV خلال فترة الاحتفاظ البالغة 24 ساعة.

ما الذي تحصل عليه

ضع العديد من طلبات API المدعومة في قائمة انتظار واجمع نتائجها من دون إبقاء اتصال العميل مفتوحاً.

نقاط النهاية

اطّلع على ما تقبله كل نقطة نهاية وما تعيده وأوضاعها وحدودها قبل التكامل.

POST /v1/batches عرض مرجع API
GET /v1/batches عرض مرجع API
GET /v1/batches/:job_id عرض مرجع API
GET /v1/batches/:job_id/results عرض مرجع API
DELETE /v1/batches/:job_id عرض مرجع API
GET /v1/jobs عرض مرجع API
GET /v1/jobs/:job_id عرض مرجع API
GET /v1/jobs/:job_id/results عرض مرجع API
POST /v1/jobs/:job_id/cancel عرض مرجع API
POST /v1/estimate عرض مرجع API
POST /v1/feedback عرض مرجع API

الوحدات والمصادقة

مجانًا المصادقة مطلوبة. راجع مرجع API لمعرفة التكلفة الدقيقة، بما في ذلك أي تسعير لكل عنصر.

مثال على عملية

استخدم العمليات الموثقة لجمع الأدلة العامة أو تقييمها أو إثرائها أو التحقق منها أو مقارنتها أو حمايتها أو مراقبتها.

POST /v1/batches الرصيد: 0

معاملات متن الطلب

المعامل النوع مطلوب
notify_webhook unknown اختياري
requests object[] مطلوب
webhook object اختياري

حقول الرد

الحقل النوع
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

طلب مثال

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))

مثال الرد

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

رموز حالة HTTP

  • 200 OK
  • 202 مقبول
  • 400 طلب غير صالح
  • 401 غير مصرح
  • 402 الدفع مطلوب
  • 409 HTTP 409
  • 429 طلبات كثيرة جداً

الأسئلة الشائعة

أين أجد مرجع طلب واستجابة دفعات API غير المتزامنة؟

استخدم مرجع API الخاص بـ دفعات API غير المتزامنة لمراجعة المعاملات وحقول الاستجابة والأمثلة ورموز الحالة وأنماط التشغيل المدعومة.

كيف أفسر النتائج غير المعروفة أو غير المكتملة من دفعات API غير المتزامنة؟

غير معروف أو جزئي يعني أننا لم نتمكن من تأكيد النتيجة بالكامل. ضع الحالة ومستوى الثقة وحداثة البيانات وأي حدود في اعتبارك عند التصرف بناءً عليها.

كيف يتم احتساب سعر دفعات API غير المتزامنة؟

يعتمد السعر على الفحص والوضع الذي تختاره. يعرض مرجع API تكلفة الأرصدة الحالية، وما إذا كنت تحتاج إلى مفتاح API، وأي تسعير لكل عنصر.

يستخدمه أشخاص في هذه الشركات

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse