لمن صُمم هذا المنتج
استخدم الأتمتة عندما يجب تنفيذ القرار نفسه عبر الزمن أو على قائمة أو عبر عدة منتجات.
ما الذي تحصل عليه
ضع العديد من طلبات API المدعومة في قائمة انتظار واجمع نتائجها من دون إبقاء اتصال العميل مفتوحاً.
غير متزامنRESTMCPSDK
اختر هذا المنتج عندما
اختر هذا المنتج عندما
اختره لوضع ما يصل إلى 100 طلب GET مدعوم في قائمة الانتظار واسترداد النتائج بصيغة JSON أو CSV خلال فترة الاحتفاظ البالغة 24 ساعة.
ما الذي تحصل عليه
ضع العديد من طلبات API المدعومة في قائمة انتظار واجمع نتائجها من دون إبقاء اتصال العميل مفتوحاً.
نقاط النهاية
راجع العمليات والمدخلات والمخرجات وأنماط التنفيذ وحدود الاستجابة المدعومة قبل التكامل.
الوحدات والمصادقة
مجانًا المصادقة مطلوبة. راجع مرجع العملية لمعرفة التكلفة الدقيقة وتسعير كل عنصر إن وُجد.
مثال على عملية
استخدم العمليات الموثقة لجمع الأدلة العامة أو تقييمها أو إثرائها أو التحقق منها أو مقارنتها أو حمايتها أو مراقبتها.
POST
/v1/batches
معاملات الجسم
| المعامل | النوع | مطلوب |
|---|---|---|
| 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"
}
}'مثال الرد
{
"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"
}
}الحدود وحدود الأدلة
تعيد المهام غير المتزامنة معرّفًا لمتابعة الحالة واسترداد النتائج لاحقًا.
تعالج العمليات المجمعة مدخلات متعددة مع الحفاظ على النتائج الموثقة لكل عنصر.
تعني الحالة الجزئية اكتمال بعض العناصر أو المكونات المطلوبة دون غيرها.
تعني الحالة المخزنة استخدام أدلة محفوظة؛ راجع بيانات الحداثة عند توفرها.
تمت المراجعة في 2026-08-22
الأسئلة الشائعة
أين أجد مرجع طلب واستجابة دفعات API غير المتزامنة؟
استخدم مرجع API الخاص بـ دفعات API غير المتزامنة لمراجعة المعاملات وحقول الاستجابة والأمثلة ورموز الحالة وأنماط التشغيل المدعومة.
كيف أفسر النتائج غير المعروفة أو غير المكتملة من دفعات API غير المتزامنة؟
تعني النتائج غير المعروفة أو الجزئية أن الأدلة المطلوبة لم تُحسم بالكامل. احتفظ بحالة النتيجة ومستوى الثقة والحداثة والحدود عند اتخاذ القرارات اللاحقة.
كيف يتم احتساب سعر دفعات API غير المتزامنة؟
تختلف الأسعار حسب العملية ونمط التنفيذ. راجع مرجع نقطة النهاية لمعرفة التكلفة الحالية ومتطلبات المصادقة وقواعد التسعير لكل عنصر.